Skip to main content
POST
Trigger Recurring Payment
Trigger a charge on an active ADHOC subscription. The call initiates the payment — the outcome (success, failure, or cancellation) arrives asynchronously by webhook, and the order and payment records are created at that point.
This endpoint only supports ADHOC subscriptions. The subscription must have an active mandate before a recurring payment can be triggered — check it with Get Subscription Mandate Status.
A 409 means the subscription’s own state refused the charge — there is no active pre-debit notification for today, or a charge is already in progress. A 400 means the amount is above the billing amount or above the pre-debit notified amount, or the reference_id is invalid or already used. In both cases nothing reached the bank: fix the cause, then call again. A 502 means the payment network failed.
For methods that use a pre-debit notification, the charge needs an active pre-debit notification for today.

Path Parameters

string
required
The unique identifier (uid) of the subscription.

Request Body

number
Amount to charge for this execution. Defaults to the subscription’s billing_amount, and must not exceed it. With a pre-debit notification it must also not exceed the notified amount.
string
Your reference for this charge: 1–50 letters, numbers and hyphens. It becomes this debit’s payment_id, so the outcome comes back under your own reference. Must be unique across your orders, including failed ones. If omitted, a payment_id is generated with a REC- prefix.

Response Fields

string
The subscription identifier.
string
Identifier of this debit: the reference_id you sent, or one generated with a REC- prefix. Store it against your order: when the debit’s outcome arrives, its payment carries this value as merchant_reference_id in the Payment Successful and Payment Failed webhooks, and as reference_id in Get Subscription Payments. A retried debit has -attempt-1, -attempt-2, and so on appended. It is not the ID of a payment record, so Get Payment does not accept it.
number
The amount charged for this recurring payment.
string
Status of the API call. success means the payment was initiated — not that it has been captured.