Skip to main content

Payment Restrictions

The API supports applying account‑level restrictions to payments. By specifying one or more restriction criteria (for example, an age requirement) in the API request, only accounts that meet all defined conditions will be permitted to complete the payment.

All restrictions must be provided as part of the customer object in the API request.

Country Restriction​

By setting the country_restriction parameter, only accounts registered in the specified country will be eligible to complete the payment.

The value must be provided as an ISO 3166‑1 alpha‑2 two‑letter country code (for example, AT, DE, FR).

Age Restriction​

The min_age parameter defines the minimum required age of the account holder.

Only accounts whose holders meet or exceed the specified age will be eligible to complete the payment.

KYC Level Restriction​

The kyc_level parameter specifies the minimum required KYC level of the customer’s PaysafeCard account.

Valid values are:

  • SIMPLE
  • FULL

Depending on the country, PaysafeCard accounts may support SIMPLE and/or FULL customer identification. Only accounts that meet or exceed the specified KYC level will be eligible to complete the payment.

Combining Restrictions​

Multiple restrictions (such as country, age, and KYC level) can be combined in a single request.
Only accounts that satisfy all configured restrictions will be allowed to complete the payment.

Example: Customer Object with KYC Level Restriction​

"customer": {
    "id": "TestUser123",
    "kyc_level": "FULL"
    }