Payment Page signature for EBANX credit card payments
This reference provides the signature parameters and request format that are required to render Payment Pages 2.0 and to process a one-time credit card payment.
Signature generation
Before you render the Payment Page, your server must generate a digital signature for the page by calling the Generate RSA signature REST API. Pass the returned signature, token, key, and tenantId values, together with the Page ID, to Z.render. For the general procedure, see Payment Pages 2.0.
To charge a customer immediately with a one-time credit card payment from the Payment Page, include the customer account and the payment details in the signed payload. Zuora validates the values on the server side. Include the following parameters when you generate the signature.
Signature parameters
| Parameter | Description |
|---|---|
field_accountId | ID of the Zuora customer account to charge. This parameter is required to process a payment from the Payment Page. |
field_currency | Transaction currency. For EBANX in India, use INR. |
field_authorizationAmount | Amount to charge the customer. |
When the customer submits the page, Zuora compares the values received from the page with the values in the signature. Zuora rejects the request if any value does not match. This check prevents the amount, currency, or account from being altered on the client side.
Example signature request
The following example shows a request body for generating the signature for a one-time credit card payment:
{
"uri": "https://<tenant-domain>/apps/PublicHostedPageLite.do",
"method": "POST",
"pageId": "<Credit Card Payment Page ID>",
"field_accountId": "<Zuora account ID>",
"field_currency": "INR",
"field_authorizationAmount": "100.00"
}Payment Page integration options
Integrate the Payment Page into your checkout experience by using one of the following options:
- Payment Pages 2.0 (iframe): Render the page in your client application. For details, see Payment Pages 2.0.
- Hosted Payment Forms and Payment SDK: Use the Zuora Payment SDK to embed a hosted credit card form. For India, ensure that the form collects the Identity Number along with the card details so that the value is available for the transaction.
When you render the page or the form, set the transaction currency to INR.