Sign in

v1

latestOpenAPI 3.0.32026-07-248079274.0 KB
Payment Methods

Generate a merchant-session

For every new Apple Pay payment request you receive a session object. You must validate your merchant identity in order to generate the merchant-session.

post/payment-methods/apple-pay/session

Headers

Company-Idstring uuid

Unique ID assigned by Acquired.com for your company.

Request body

domainstring required

The domain / subdomain that you are loading the Apple Pay payment sheet from. This must also be registered in the Hub.

display_namestring required

The name of your store as it will be displayed to the user on the Apple Pay payment sheet.

validation_urlstring uri required

The URL that your server must use to validate itself and obtain a merchant session object.

Example request

{
  "domain": "store.mydomain.com",
  "display_name": "myStore",
  "validation_url": "https://apple-pay-gateway.apple.com/paymentservices/startSession"
}

Response

OK

merchant_sessionstring

At the end of the Apple Pay process, an encrypted payload is returned to your application. The merchant must base64 the payload and submit through to us in the payment.token field of the request.

Example response

{
  "merchant_session": "{{Base64}}"
}