Start a transaction
If you have a PSP configured you can start a transaction. As to make the integration with GoMeddo Payments 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. |
Shopper Locale | Locale of where the payment originated. This is important for the PSP to understand which payments options to display as well as which language to display the HPP. |
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.
Supported Locales
Most payment service providers support the following locales for the HPP with Adyen supporting the complete list. If a locale isn’t supported for translations the fallback en-US will be used.
Arabic - International | ar |
Chinese - Simplified | zh-CN |
Chinese - Traditional | zh-TW |
Croatian | hr-HR |
Czech | cs-CZ |
Danish | da-DK |
Dutch | nl-NL |
English - US | en-US |
Finnish | fi-FI |
French | fr-FR |
German | de-DE |
Greek | el-GR |
Hungarian | hu-HU |
Italian | it-IT |
Japanese | ja-JP |
Korean | ko-KR |
Norwegian | no-NO |
Polish | pl-PL |
Portuguese - Brazil | pt-BR |
Portuguese - Portugal | pt-PT |
Romanian | ro-RO |
Russian | ru-RU |
Slovak | sk-SK |
Slovenian | sl-SI |
Spanish | es-ES |
Swedish | sv-SE |