paymentRequest

The paymentRequest object allows to transmit the information related to the payment.

It has the following attributes:

Table 1. The paymentRequest object
paymentRequest
Attribute Required Format
amount

Transaction amount in the smallest currency unit (cents for euro).

Note:

  • Must not be submitted empty or be equal to 0.
  • Must not exceed the initial amount (example: refund).
n..12
currency

Currency code of the transaction (ISO 4217 standard).

E.g.: 978 for euro (EUR)

n3
expectedCaptureDate

Requested capture date in ISO 8601 format defined by W3C.

Example: 2016-07-16T19:20:00Z.

This parameter is used for making deferred payments.

If the number of days between the requested capture date and the current date is greater than the authorization validity period, an authorization for 1 EUR (or information request about the CB network if the acquirer supports it) will be made on the day of the transaction. This will be done to verify that the card validity.

The authorization for the total amount will be made:

  • by default: on the desired capture day,
  • case of anticipated authorization: depending on the chosen payment method, D- the number of days corresponding to the authorization validity period before the desired capture date in the bank.

If you wish to be notified about the result of this authorization request, configure the notification URL upon Batch authorization notification rule in the Expert Back Office (Settings > Notification rules).

Note: if the capture delay is higher than 365 days in the payment request, it will be automatically reset to 365 days.

  dateTime ans..40
manualValidation

Allows to manually validate a transaction previously created with manual validation as long as the desired capture date has not passed.

To do so, this attribute must be set to 1 (manual validation).

Notes:

  • If the payment was created with automatic validation, there is no need for the manualValidation attribute
  • If manualValidation is set to 0, the requested action will not be taken into account.
  n1
acquirerTransientData

Allows to transmit useful information to the acquirer for performing fraud assessment:

URL of the shop, name of the shop, order number, shipping fees, delivery method, etc.

Example:

acquirerTransientData = {VISANET={ "field91": "10XXXXXXX", "field92": "Lyra Peru", "field93": "specific data" }}

json