PayPal Recurring (Billing Agreement)

Initial setup of a billing agreement via Hosted Payment Page

📘

Pre-conditions

On the gateway side, your account must be set up with the Data Vault / Hosted Data service.

Please contact PayPal to verify if your PayPal business account meets the PayPal requirements for this feature.

Besides sending the paymentMethod as 'paypal', you need to submit the parameter chargetotal with a zero value in your preauthorization request. Such transaction request is always used to create a Billing Agreement ID on the PayPal side, returned to you in the field hostedDataId

Transaction Response

Response parameterDescription
approval_codeTransaction approval code. Initial character indicates the transaction status.
‘Y’ – Transaction approved
‘N’ – Transaction declined
‘?:waiting PAYPAL’ – Transaction has been initiated but a final result is not yet available
statusTransaction status, e.g. ‘APPROVED’, ‘DECLINED’, ‘FAILED’ or ‘WAITING’
hostedDataIdStores “Billing Agreement ID”
snameShip-to Name
saddr1Shipping Address
scityShipping City
scountryCountry of Shipping Address
szipZip or Postal Code
fail_reasonIndicates why the transaction was declined
ipgTransactionIdIt is mapped to the PayPal Custom. You will be able to see this value in your PayPal seller account while reviewing a transaction
refnumberRepresents the PayPal Transaction ID. The value will be visible in your PayPal seller account while reviewing a transaction

Initate a recurring PayPal transaction using the billing agreement

In order to execute a recurring or subsequent payment transaction based on the billing agreement, you need to use our RESTful payment API. Please refer to:


Want a quick overview?