Backend API
The backend API is the part of PayEx Checkout that is responsible for handling communication with the backend code of the client implementation, such as the web shop. The backend API is used to create a Payment Session associated with a purchase button, to check status of the Payment and to perform additional operations on the payment, such as Capture.
Backend API Urls
Environment | Url |
---|---|
Test | https://api.externalintegration.payex.com/psp/checkout |
Production | https://api.payex.com/psp/checkout/ |
Authentication
The authentication for the API uses the Merchant token issued through the PayEx Merchant Administration web interface. This token is sent as a HTTP Authorization header like this:
Authorization: Bearer <access_token>
Any requests without the correct authentication will result in a 401 Unauthorized response from the PayEx Checkout API.
Resources
Resource | Usage |
---|---|
Home | Used to retrieve information about the PayEx Checkout API and to discover the URL of the Payment Session resource. |
Payment Session | Used to create a Payment Session and to retrieve status about the associated Payment and Payer. |
Payment | Used to retrieve information about the payment and to perform additional operations on the payment, such as Capture. |
Addressee | Used to retrieve adressee information (physical or digital delivery address) about the person who paid for the goods or service. |
Callbacks | Used to retrieve information about the payment when payment changes status. |