If you have a PSP configured you can start a transaction. As to make the integration with Payment25 as easy as possible we always provide the hosted payment page (HPP) solution of a payment service provider. This means that the customer will choose their preferred method for payments on the page of the PSP rather than on the website where the payment flow is implemented.
To start a transaction make the following API call:
Field Name | Defintion |
|---|---|
Reference | This is a unique reference to this specific payment, make sure this value is unique for every payment you start. |
Value | The value in cents. |
Currency | Country codes in ISO 3166-1 alpha-3 format. |
Shopper Reference | This is the reference to the object that you’re making the payment for. In case of an order that you’re making a transaction for using the order ID would be the most logical here. |
Description | The description shown on the bank statement. |
Country Code | Country codes in ISO 3166-1 alpha-2 format. |
Shoper Locale | Locale of where the payment originated. This is important for the PSP to understand which payments options to display. |
Callbacks → Return Url | After the payment has completed or failed the customer will be redirected here. |
Presenting the payment
After you’ve started a payment the response will contain a URL:
{
"transaction_id": "cce9181c-cedd-4596-b784-6f64e7a3d408",
"reference": "fdb892d2-cd4b-4b88-9d87-6deb43c466d1",
"status": 0,
"description": "Payment",
"shopper_reference": "53ceee12-b74d-4f4b-85ed-7f6d665fb3a2",
"amount": 3500,
"currency": "EUR",
"country_code": "NL",
"shopper_locale": "nl-NL",
"url": "https://eu.adyen.link/PLB0CDE424561AB1356"
}
Redirect your customer to this destination, this is where the transaction will start.
Please be aware that this URL has to be opened in a tab or window and cannot be used in an iframe due to security measures taken by the PSPs.