Recurring

Recurring transactions usually are only available when specifically agreed upon.

The recurring functionality allows merchants to complete a transaction using saved card information from a previous transaction. This means that it is not necessary to enter card details for subsequent transactions.

Recurring transactions are very much the same as normal card transactions. Please take a look at the card integration guide for more information about the normal card integration.

For more information see the API documentation.

Required fields

Recurring transactions have a couple of additionally required fields:

First transaction Repeat transaction(s)
  • recurring_type
  • customer
  • recurring_type
  • customer
  • card

See the card integration guide for more information about creating a customer object.

First transaction initialization

In addition to the normal initializing a card transaction request you have to supply the recurring_type and customer parameter.

Here is a valid request body that initiates the first recurring card transaction:

{
    "payment_profile": "7c23a50d-8699-431c-a82b-a78718d2b6f6",
    "amount": 14,
    "customer": "cbbfa6ec-fb44-4da4-94c4-d81e92fd43e6",
    "customer_ip": "127.0.0.1",
    "details": {
        "redirect_url": "https://example.com/finalize"
    },
    "dynamic_descriptor": "orderdesc01",
    "merchant_reference": "my order id",
    "payment_product": "card",
    "recurring_type": "first",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/86.0.4240.198 Safari/537.36",
    "webhook_transaction_update": "https://example.com"
}

Obtain the card ID

When the transaction has been completed successfully you would usually request the transaction information via the following endpoint:
GET /v1/transaction/{Transaction ID}

Collect the card field from this response. This is the Card ID required for subsequent transactions.

Subsequent transaction initialization

In addition to the normal initializing a card transaction request you have to supply the recurring_type, customer and card parameter.

Here is a valid request body that initiates the subsequent recurring card transaction:

{
    "payment_profile": "7c23a50d-8699-431c-a82b-a78718d2b6f6",
    "amount": 14,
    "card": "a61335cf-8c8b-4a75-a259-fd4dac62fb37",
    "customer": "cbbfa6ec-fb44-4da4-94c4-d81e92fd43e6",
    "customer_ip": "127.0.0.1",
    "details": {
        "redirect_url": "https://example.com/finalize"
    },
    "dynamic_descriptor": "orderdesc01",
    "merchant_reference": "my order id",
    "payment_product": "card",
    "recurring_type": "repeat",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/86.0.4240.198 Safari/537.36",
    "webhook_transaction_update": "https://example.com"
}