Enable recurring payments

Enable recurring payments.

About recurring payments

Recurring payments allow you to debit your customer’s account with a fixed or variable amount on a regular basis for the recurring services. You can also use recurring payments for single debit transactions.

Some of the recurring payment examples include:

• Membership fees
• Subscription to a regular or varying service
• Registration within a shop to avoid reentering the payment data
• Trial period, which require an initial registration for a service later

You can accept recurring payments in the following two ways:

1. Accepting recurring payments without the customer being present during the transaction.
2. Saving a customer’s payment method and corresponding details only for the Accept payments with a payment page.

Supported payment methods

Currently, the following payment methods support recurring:

• Card
• PayPal
• Unzer Direct Debit

Registering a credit card

For more details on recurring payments for credit cards, see credit cards.

Registering PayPal

To register PayPal as a recurring payment, implement the following flow:

1. Initially, the customer goes to PayPal settings and enables a flag to allow recurring payments without customer interaction on their account.
2. Create a new PayPal /types/<pay_pal_id>/recurring resource.
3. Redirect the customer to the redirect URL.
4. The customer logs in to their PayPal account and chooses their preferred payment option.
5. After the customer enters their payment details, the PayPal types resource is successfully registered as recurring. Now, PayPal can be used for direct charges without further customer interaction.

Example request: Accept recurring payments

To accept recurring payments, make a POST call to types/<paymentId>/recurring, with a private key and the following parameters in the request body:

POST https://api.unzer.com/v1/types/<paymentId>/recurring

Body:
{
  "returnUrl" : "https://www.unzer.com"
}

{
    "isSuccess": false,
    "isPending": true,
    "isError": false,
    "redirectUrl": "https://api-payment.unzer.com/v1/redirect/3ds/s-I98KIK9alGzO",
    "message": {
        "code": "COR.000.200.000",
        "customer": "Transaction pending"
    },
    "returnUrl": "https://www.unzer.com",
    "date": "2019-03-07 11:42:47",
    "resources": {
        "customerId": "",
        "metadataId": ""
    },
    "processing": {
        "uniqueId": "31HA07BC8110C3EE06224EB9C3FC44C2",
        "shortId": "4158.8536.7528"
    }
}

Registering Unzer Direct Debit

To use the recurring feature for Unzer Direct Debit, implement the following flow:

1. Make a POST call to payments/charges.
2. After a successful charge, the Unzer Direct Debit resource is automatically set as recurring.