PaysafeCard

SK Integration option

Payment

Info

This integration option supports only EUR and USD currencies.

Payment flow

The customer initiates the payment on the merchant's website.
The merchant sends the payment request to Demo PSP.
Demo PSP sends a response containing the URL for completing the payment.
The merchant redirects the customer to the provided URL.
The customer completes the payment.
Demo PSP sends a webhook notification with the payment status to the merchant.

Request

Send a payment request with the following additional parameters:

object

return_url

required

string
A URL to return the customer to when a transaction is completed.

language

string
A language of the provider's payment page. Possible values: BG, JA, CS, KO, DA, NL, DE, PL, EL, PT, EN, RO, ES, RU, FI, SV, FR, TR, IT, ZH.

object
Секция параметров способа оплаты.

type required	string `pay_safe_card`
account_number required	string The identifier of the customer's account, in this integration option – the customer's email.

object
A section of information about the customer.

first_name	string The customer's first name.
last_name	string The customer's last name.
country	string The customer's country. Possible values: AU (Australia), AT (Austria), BE (Belgium), BG (Bulgaria), HR (Croatia), CY (Cyprus), CZ (Czech Republic), DK (Denmark), FI (Finland), FR (France), DE (Germany), HU (Hungary), IS (Iceland), IE (Ireland), IT (Italy), LV (Latvia), LT (Lithuania), LU (Luxembourg), MT (Malta), NL (Netherlands), NZ (New Zealand), NO (Norway), PY (Paraguay), PL (Poland), PT (Portugal), RO (Romania), SK (Slovakia), SI (Slovenia), ES (Spain), SE (Sweden), CH (Switzerland), GB (United Kingdom), UY (Uruguay), US (USA).

Request example

{
  "request": {
    "amount": 100,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://merchant.ltd/return",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "DE"
    },
    "method": {
      "type": "pay_safe_card",
      "account_number": "example@example.com"
    }
  }
}

Response

Redirect your customer to the URL received as the value of the form.action parameter.

Response example

{
  "transaction": {
      "uid": "b79cd2e2-2598-482c-9336-ebbec6a43e62",
      "type": "payment",
      "status": "pending",
      "amount": 100,
      "currency": "EUR",
      "description": "description",
      "created_at": "2025-05-06T12:32:01Z",
      "updated_at": "2025-05-06T12:32:02Z",
      "method_type": "pay_safe_card",
      "receipt_url": "https://demo-backoffice.begateway.com/customer/transactions/b79cd2e2-2598-482c-9336-ebbec6a43e62/9fc125f86dd695c0398101350a5853c22d68f0cd5ca446440c2d0f133b8e7e06",
      "payment": {
          "status": "pending",
          "gateway_id": 5334,
          "message": "Transaction was initialized."
      },
      "pay_safe_card": {
          "type": "pay_safe_card"
      },
      "customer": {
          "first_name": "John",
          "last_name": "Doe",
          "country": "DE",
          "email": null,
          "ip": null
      },
      "manually_corrected_at": null,
      "version": 0,
      "message": "Transaction was initialized.",
      "test": false,
      "billing_address": {
          "first_name": "John",
          "last_name": "Doe",
          "country": "DE"
      },
      "additional_data": {
          "payment_method": {
              "type": "alternative"
          }
      },        
      "gateway": {
          "iframe": false
      },
      "form": {
          "action": "payment_url",
          "method": "GET",
          "fields": []
      }
  }
}