Integration
The Click to Pay process is made up of the following key steps. Configure the CaptureContextOptions with:
- Your Merchant Identifier (GUID)
- Whitelisted domains
- Currency
- Country
- Locale
- Order information
- A callback for handling the payment once the user approves
- Create a CaptureContext instance using the configured options.
- Send the data (e.g. transientToken and identifier) to Buckaroo via server-to-server call to complete the payment. The Click to Pay button and experience is rendered via the SDK, which handles authentication and secure token generation.
Explanation of available fields:
| Field | Required | Description |
|---|---|---|
| MerchantIdentifier | (REQUIRED) | Your merchant GUID |
| TargetOrigins | (REQUIRED) | Array of target origins of the websites you will be launching Click to Pay |
| Currency | (REQUIRED) | ISO 4217 |
| Country | (REQUIRED) | ISO 3166 |
| Locale | (REQUIRED) | ISO 639-1 _ ISO 3166 (e.g. nl_NL) |
| OrderInformation | (REQUIRED) | Is used to display a total price for the order. See sample code for the format. |
| ProcessPaymentCallback | (REQUIRED) | Callback: for capturing funds. This callback is executed when the user successfully authenticates the payment intent with ClickToPay. The Identifier and encrypted TransientToken needs to be sent to Buckaroo via a server-to-server API request. |
Required steps and prerequisites
To integrate Click to Pay successfully, there are a few required steps and configurations to complete:
Register an application in Buckaroo Plaza.
- Log in to Buckaroo Plaza
- Go to Settings > Token Registration
- Click _Register New Application _(top-right)
- In the modal:
- Enter a name for your application
- Select the scope: clicktopay - save
- Click Save
You will receive a Client ID and Client Secret which you will use in your frontend code to initialize the Click to Pay session.
Updated about 11 hours ago