Skip to content

PaysafeCard

DC Integration option

Payment

Payment Flow

  1. The customer initiates the payment on the merchant's website.
  2. The merchant sends a payment request to PaySage.io.
  3. PaySage.io responds with a link to the payment page.
  4. The merchant redirects the customer to the payment page.
  5. The customer completes the payment.
  6. PaySage.io sends a webhook notification with the payment status to the merchant.

Info

This integration option supports AUD, CAD, CHF, EUR, GBP, NOK, PLN, RON, SEK and USD currencies.

Request

Send a payment request with the following additional data:
object
return_url
required
 string
URL to return the customer to when the transaction is completed.
object
A section of the payment method.
type
required
 string
pay_safe_card
ip
 string
The customer's IP address.
object
A section of the customer details.
first_name
required
 string
The customer's first name.
last_name
required
 string
The customer's last name.
country
required
 string
The customer's country in the ISO 3166-1 Alpha-2 format. Possible values: AT (Austria), AU (Australia), BE (Belgium), BG (Bulgaria), CA (Canada), CH (Switzerland), CY(Cyprus), CZ (Czech Republic), DE (Germany), DK (Denmark), ES (Spain), FI (Finland), FR (France), GB (United Kingdom), GE (Georgia), GI (Gibraltar), GR (Greece), HR (Croatia), HU (Hungary), IE (Ireland), IT (Italy), LI (Liechtenstein), LT (Lithuania), LU (Luxembourg), MT (Malta), MX (Mexico), NL (Netherlands), NZ (New Zealand), NO (Norway), PE (Peru), PL (Poland), PT (Portugal), RO (Romania), SE (Sweden), SI (Slovenia), SK (Slovakia), UY (Uruguay).
phone
 string
The customer's phone number.
email
 string
The customer's email address.
city
 string (120)
The customer's billing city.
zip
 string (40)
The customer's billing ZIP or postal code.
birth_date
 string
The customer's date of birth in the ISO 8601 format (YYYY-MM-DD).
address
 string (510)
The customer's billing address.
Request example 
{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return.com",
        "language": "en",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "AT" 
        },
        "method": {
            "type": "pay_safe_card"
        }
    }
}
Response

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

Response example 
{
    "transaction": {
        "uid": "e6894788-e26b-43e6-8ad1-19f4c61e9805",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-09-17T13:57:34Z",
        "updated_at": "2025-09-17T13:57:35Z",
        "method_type": "pay_safe_card",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/e6894788-e26b-43e6-8ad1-19f4c61e9805/08a86c85fafc9e946abdbbf2f8cbdf9fc7d34c6d14d3939a2b344ebf621e4280?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5220,
            "ref_id": "affd698b62d69be9eaf0",
            "message": "Transaction was initialized."
        },
        "pay_safe_card": {
            "type": "pay_safe_card"
        },
        "customer": {
            "country": "AT",
            "last_name": "Doe",
            "first_name": "John",
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "language": "en",
        "billing_address": {
            "country": "AT",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link_to_payment_page",
            "fields": [],
            "method": "GET"
        }
    }
}

Refund

Request

Send a standard refund request. The amount value must not exceed the amount of the parent transaction. It is possible to make multiple refunds for the same payment transaction, in this case the sum of refund amounts must not exceed the amount of the corresponding payment transaction.