Sign in

v1

latestOpenAPI 3.0.32026-07-248079274.0 KB
Components

Update a session_id

This request allows you to update any details of the previously created session_id. Submit a request containing the parameters to be updated, when the payment is completed within Components. the authorisation request will use the latest parameters set against the session_id.

put/payment-sessions/{session_id}

Path parameters

session_idstring uuid required

Unique ID assigned by Acquired.com which contains the payment information that will be loaded when initialising the Components checkout.

Request body

webhook_urlstring uri

Where we should send webhook notifications throughout the authorisation process.

payment_methodsstring[]

Used to specify which payment methods should be displayed on the Checkout. (This can only be passed when using the Payment component).

Example request

{
  "transaction": {
    "order_id": "1f1f2a61-5b68-4725-a0ce-9560514ec00b",
    "amount": 15.02,
    "currency": "gbp",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh"
  },
  "customer": {
    "reference": "customer_number_00001",
    "first_name": "Edward",
    "last_name": "Johnson",
    "dob": "1988-10-03",
    "custom_data": "L3BheW1lbnQtbGlua3MgcGF5IGN1c3RvbV9kYXRh",
    "billing": {
      "address": {
        "line_1": "152 Aldgate Drive",
        "city": "London",
        "postcode": "E1 7RT",
        "country_code": "GB"
      },
      "email": "ejohnson@acquired.com",
      "phone": {
        "country_code": "44",
        "number": "2039826580"
      }
    },
    "shipping": {
      "address": {
        "line_1": "152 Aldgate Drive",
        "city": "London",
        "postcode": "E1 7RT",
        "country_code": "GB"
      },
      "email": "ejohnson@acquired.com",
      "phone": {
        "country_code": "44",
        "number": "2039826580"
      }
    }
  },
  "tds": {
    "challenge_preference": "no_preference",
    "challenge_window_size": "full_screen",
    "contact_url": "https://example.com/contact",
    "redirect_url": "https://example.com/redirect",
    "webhook_url": "https://example.com/webhook"
  },
  "webhook_url": "https://example.com/webhook"
}

Response

OK

status'success'

The outcome of the request