Skip to main content
Skip table of contents

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:

CODE
{
	"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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.