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

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