Skip to main content

setupRecurring Method

Overview

The setupRecurring method establishes a payment mandate for future charges.

Request Fields

FieldTypeRequiredDescription
merchantRecurringPaymentIdstringYesYour recurring setup ID
amountMoneyYesInitial amount
paymentMethodPaymentMethodYesCard details
addressPaymentAddressYesBilling address
authTypestringYesTHREE_DS or NO_THREE_DS

Response Fields

FieldTypeDescription
statusPaymentStatusACTIVE, FAILED
mandateReferencearrayMandate ID and status

Example

$request = [
'merchantRecurringPaymentId' => 'recurring_001',
'amount' => ['minorAmount' => 2900, 'currency' => 'USD'],
'paymentMethod' => ['card' => [...]],
'address' => ['billing' => [...]],
'authType' => 'NO_THREE_DS'
];
$response = $paymentClient->setupRecurring($request);