One-time payments
Below you will find two general scenarios of how to make a one-time payment. You can pass card details with open parameters or use the payment form. In both cases, you must comply with the PCI DSS requirements.
All API operations are carried out within a payment session. One payment session can include several operations: for example, you can accept and then refund a payment.
- You are passing card details with open parameters
- You are using our payment widget
To create a one-time payment, complete the following steps:
-
Create a payment session sending a
session/createrequest.Alternatively, you can use the
session/init/paymentmethod. In this case, specify all the payment parameters right away and skip the next step. -
Send a
session/start/paymentrequest to start the payment. -
Wait for a
ready_to_confirmwebhook. When you receive it, it means that Smart Glocal is ready to make the payment and is waiting for your confirmation. -
Send a
session/confirmrequest or asession/cancelrequest to confirm or cancel the operation. -
If you receive an
action_requiredwebhook, it means that you need to take an additional action to perform the payment. For instance, the user might need to go through 3D Secure. Redirect the user for 3D Secure authentication using the link from the webhook. -
Wait for a
payment_finishedwebhook containing the result of the payment. If the status issucceeded, the payment was successful.
Sequence diagram of payments without use of the payment form

To create a one-time payment using our payment widget, complete the following steps:
-
Complete Steps 1–5.
If you receive an
action_requiredwebhook, send the HTTP 200 OK in response but do nothing, as the user will be redirected for 3D Secure within the widget. -
Wait for a
ready_to_confirmwebhook. When you received it, it means that Smart Glocal is ready to make the payment and is waiting for your confirmation. -
Send a
session/confirmrequest or asession/cancelrequest to confirm or cancel the operation. -
Wait for a
payment_finishedwebhook containing the result of the payment. If the status issucceeded, the payment was successful.
Sequence diagram of payments with the payment widget
