Recurring

PaysafeCard supports recurring payments based on following two flows, and we streamline both with Payment agreements:

  • One-Click Payments: A streamlined checkout that lets consumers complete future purchases with a single click, bypassing the need for re-authentication.

  • Recurring Payments: Simplifies subscriptions by allowing merchants to automatically charge the tokenized card without needing the consumer's active involvement.

Once a consumer authorizes their initial payment, PPRO then stores a multi-use payment handle token linked to the consumer, which backs all subsequent charges.

Create the payment agreement

To create a Paysafecard payment agreement, provide the following information when calling our payment agreements endpoint:

FieldDescription
paymentMethodPAYSAFECARD
amount.typeEXACT
amount.valueThe recurring charge amount in the smallest currency unit. This becomes the authorized amount for all subsequent charges.
amount.currencyCHF, EUR, GBP, HUF, NOK, PLN, RON, SEK.
consumer.countryAE, AT, AU, BE, BG, CA, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GE, GI, GR, HR, HU, IE, IS, IT, KW, LI, LT, LU, LV, MD, MT, MX, NL, NO, NZ, PE, PL, PT, PY, RO, SA, SE, SI, SK, UY
authenticationSettings: REDIRECT settings.returnUrlSpecify the URL to which the consumer should be redirected after completing the payment. This is required for the REDIRECT payment flow.
initiatorCONSUMER for One-click, or MERCHANT for Recurring.
scheduleTypeUNSCHEDULED (optional) for One-click, or SCHEDULED for Recurring.

For Recurring, the following fields are also mandatory:

FieldDescription
frequency.typeFor Recurring, only. The type of frequency between consecutive payment charges. Allowed: WEEKLY, MONTHLY or YEARLY.
frequency.intervalFor Recurring, only. The interval between consecutive payment charges.

In this flow, you can also include the initialPaymentCharge object in this agreement creation call to immediately initiate the first payment without making a separate call. If you include this object, you'll need to specify:

  • The exact amount.value and amount.currency of the first payment.

If you don't include an initialPaymentChargeduring agreement creation, you'll need to make a separate API call to /v1/payment-agreements/{agreement_id}/payment-charges to create the first charge.

Request

POST /v1/payment-agreements

{
    "paymentMethod": "PAYSAFECARD",
    "description": "Description",
    "amountType": "EXACT",
    "amount": {
        "value": 1000,
        "currency": "EUR"
    },
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "initialPaymentCharge": {
        "initiator": "CONSUMER",
        "scheduleType": "UNSCHEDULED",
        "amount": {
            "value": 1000,
            "currency": "EUR"
        }
    },
    "authenticationSettings": [
        {
            "type": "REDIRECT",
            "settings": {
                "returnUrl": "https://merchant.com/paysafecard/return"
            }
        }
    ]
}
{
    "paymentMethod": "PAYSAFECARD",
    "description": "Monthly subscription",
    "amountType": "EXACT",
    "frequency": {
        "interval": 1,
        "type": "MONTHLY"
    },
    "amount": {
        "value": 1000,
        "currency": "EUR"
    },
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "initialPaymentCharge": {
        "initiator": "MERCHANT",
        "scheduleType": "SCHEDULED",
        "amount": {
            "value": 1000,
            "currency": "EUR"
        }
    },
    "authenticationSettings": [
        {
            "type": "REDIRECT",
            "settings": {
                "returnUrl": "https://merchant.com/paysafecard/return"
            }
        }
    ]
}
{
    "paymentMethod": "PAYSAFECARD",
    "description": "Monthly subscription",
    "amountType": "EXACT",
    "frequency": {
        "interval": 1,
        "type": "MONTHLY"
    },
    "amount": {
        "value": 1000,
        "currency": "EUR"
    },
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "authenticationSettings": [
        {
            "type": "REDIRECT",
            "settings": {
                "returnUrl": "https://merchant.com/paysafecard/return"
            }
        }
    ]
}

Response

You'll receive our standard payment agreement response:

{
    "id": "agr_dqLrOcwMiuYOAbMCzihGa",
    "status": "AUTHENTICATION_PENDING",
    "description": "Description",
    "paymentMethod": "PAYSAFECARD"
    },
    "startDate": "2026-10-16T19:40:11.845Z",
    "amount": {
        "value": 1000,
        "currency": "EUR"
    },
    "instrumentId": "instr_GcZjyRVEI69vKqyyxiJCv",
    "amountType": "EXACT",
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "authenticationMethods": [
        {
            "details": {
                "requestUrl": "https://redirections/example.mukEmRm4iRxIe0tu5aAbbZY6Sw",
                "requestMethod": "GET"
            },
            "type": "REDIRECT"
        }
    ],
    "history": [
        {
            "id": "ahist_aaMSpSkw99sEzlaNnuh83",
            "status": "AUTHENTICATION_PENDING",
            "createdAt": "2026-10-16T19:40:12.313Z"
        }
    ],
    "revocations": [],
    "createdAt": "2026-10-16T19:40:12.313Z",
    "updatedAt": "2026-10-16T19:40:12.313Z"
}
{
    "id": "agr_dqLrOcwMiuYOAbMCzihGa",
    "status": "AUTHENTICATION_PENDING",
    "description": "Description",
    "paymentMethod": "PAYSAFECARD",
    "frequency": {
        "type": "MONTHLY",
        "interval": 1
    },
    "startDate": "2026-10-16T19:40:11.845Z",
    "amount": {
        "value": 1000,
        "currency": "EUR"
    },
    "instrumentId": "instr_GcZjyRVEI69vKqyyxiJCv",
    "amountType": "EXACT",
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "authenticationMethods": [
        {
            "details": {
                "requestUrl": "https://redirections/example.mukEmRm4iRxIe0tu5aAbbZY6Sw",
                "requestMethod": "GET"
            },
            "type": "REDIRECT"
        }
    ],
    "history": [
        {
            "id": "ahist_aaMSpSkw99sEzlaNnuh83",
            "status": "AUTHENTICATION_PENDING",
            "createdAt": "2026-10-16T19:40:12.313Z"
        }
    ],
    "revocations": [],
    "createdAt": "2026-10-16T19:40:12.313Z",
    "updatedAt": "2026-10-16T19:40:12.313Z"
}

Pick the desired authentication method

REDIRECT

Redirect your consumer to the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestUrl For example, with the value of https://redirection-target.ppro.com/ using the returned $.authenticationMethods[?(@.type == "REDIRECT")].details.requestMethod HTTP method.

REDIRECT

  1. After the consumer completes the authentication, they are redirected to the returnUrl specified in the payment charge creation request.
  2. Upon redirect back to your site, retrieve the latest agreement status by performing a GET /v1/payment-agreements/{agreementId}. Use the returned status field to determine and display the final payment outcome to the consumer.
  3. Additionally, webhooks are triggered to notify you of the payment result. This ensures you receive the outcome even if the consumer closes their browser or fails to return to your website.

Create a recurring payment

To initiate a subsequent recurring payment, send a request against an active agreement using our payment agreements API.

Request

POST /v1/payment-agreements/agreementId/payment-charges

{
  "amount": {
    "value": 1999,
    "currency": "EUR"
  }

Response

{
    "id": "charge_N9lRrX0aCxIjO21fkPHSh",
    "paymentMethod": "PAYSAFECARD",
    "currency": "EUR",
    "country": "DE",
    "paymentDescriptor": "Payment Descriptor",
    "instrumentId": "instr_Nb7O43ofycs0JJhPZPeEg",
    "status": "CAPTURED",
    "consumer": {
        "name": "John Smith",
        "country": "DE"
    },
    "order": {
        "orderItems": [
            {
                "name": "Product Name 1",
                "quantity": 1,
                "amount": 1
            }
        ],
        "industryData": []
    },
    "authorizations": [
        {
            "id": "authz_OOS1uQABVWpzda0ZcV9ym",
            "amount": 10,
            "status": "AUTHORIZED",
            "merchantPaymentChargeReference": "ed3eab7e-8712-405b-a1ec-337d228fd5b0",
            "createdAt": "2026-10-20T10:07:49.788Z",
            "updatedAt": "2026-10-20T10:07:49.788Z"
        }
    ],
    "captures": [
        {
            "id": "capture_2fuM45oxMt55fnD1UvRGU",
            "amount": 10,
            "status": "CAPTURED",
            "merchantCaptureReference": "ed3eab7e-8712-405b-a1ec-337d228fd5b0",
            "createdAt": "2026-10-20T10:07:49.788Z",
            "updatedAt": "2026-10-20T10:07:49.788Z"
        }
    ],
    "refunds": [],
    "voids": [],
    "createdAt": "2026-10-20T10:07:49.714Z",
    "updatedAt": "2026-10-20T10:07:49.788Z"
}

Handling insufficient balance

One-click top-up

For One-click charges (where initiator = CONSUMER), an insufficient balance decline doesn’t always end the charge. If Paysafecard provides a top-up URL, the consumer can add funds and complete the charge. This applies only to consumer-initiated charges declined for insufficient balance. Every other decline reason, and every decline on a merchant-initiated charge, fails immediately.

For Initial One-Click charge

Redirect the consumer to the requestUrl as usual. From there, they can top up their card balance and complete authentication.

For a subsequent One-Click charge

Redirect the consumer to the requestUrl, just as you would for the original payment. They can top up their balance and complete the charge from that page.

Recurring charge

Recurring charges (where initiator = MERCHANT) run off session, so the consumer isn’t present. If one is declined for insufficient balance, the charge status may move to PENDING instead of FAILED. This gives the consumer time to top up their card balance. The top-up happens out of band, after a grace period. PPRO then sends a webhook with the final outcome, either FAILED or CAPTURED.

⚠️

Token lifecycle

The payment handle token behind an agreement follows Paysafecard's own lifecycle rules, which are separate from your agreement's endDate. The token expires 365 days after it's created. When that happens, PPRO sets the agreement status to REVOKED_BY_PROVIDER, sends you a webhook for this & blocks any further charge attempts against it. To keep billing the consumer, you'll need to collect a new consent from them.

Additional Information

Before you go live

  • Paysafecard recurring is generally available to any merchant that processes Paysafecard one-time payments. To turn it on for your account, just reach out to your PPRO Account Manager and they'll get it activated.
  • Request your PPRO Account Manager for the staging account to test in Sandbox.

Did this page help you?