API ReferenceWebpos

Fetch Web Pos Payment

Fetch a Web POS payment and track its status.

Required OAuth 2.0 scope: business/webpos:read

Path parameters

webpos_device_idstringRequiredformat: "uuid"
payment_idstringRequiredformat: "uuid"

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Response

Successful Response
amountobject
The amount of money to charge the buyer.
client_referencestring
The reference value provided by the host POS when the Web POS payment was created.
created_atstringformat: "date-time"
The date and time the Web POS payment was created, in ISO 8601 format.
idstringformat: "uuid"
The unique ID for the Web POS payment. Can be used to fetch Web POS payment.
redirect_urlstring
The URL that can be loaded into an iFrame, window, or new tab to accept merchant input via their browser. The loaded web application can be used by the merchant to confirm the payment session and monitor its progress.
statusenum
The status of the Web POS payment.
Allowed values:
updated_atstringformat: "date-time"
The date and time the Web POS payment was last updated, in ISO 8601 format.
webpos_device_idstringformat: "uuid"
The Web POS Device which created the payment.
metadatamap from strings to strings or null
The metadata provided by the host POS when the Web POS payment was created.
payment_detailsobject or null
Payment outcome related details. Only available once the terminal has captured card data and submitted to upstream services.
terminalobject or null

The terminal that’s been selected to process this payment. Only available if a terminal has been chosen by an operator or auto-selected.

Errors