Request Fields
Initial Request (Hosted and Direct Integration)
These fields should be sent in addition to the Basic Request Fields excluding any card details.
| Field Name | Mandatory? | Description |
|---|---|---|
| paymentMethod | Yes[1] | Payment method to be used with PPRO (eg ppro.astropay, ppro.alipay, etc). |
| checkoutRedirectURL | Yes[2] | URL on Merchant’s server to return to when the PPRO APM Checkout is closed. |
| checkoutOptions | No[3],[4] | Record containing options used to customise the PPRO APM Checkout. Refer here. |
| pproCheckoutOptions | No[5],[4] | Record containing options used to customise the PPRO APM Checkout. Refer here. |
Checkout Options (Hosted and Direct Integration)
The following options may be sent in the pproCheckoutOptions Hosted Integration field or the checkoutOptions Direct Integration field to customise the Checkout. The options must be formatted using the record or serialised record formats.
| Sub-Field Name | Description |
|---|---|
| nationalid | Consumer’s national ID (up to 30 characters). |
| consumerref | Unique reference identifying the consumer within 1 to 20 characters and a format of A-Za-z0-9.%,&/+*$- |
| siteid | Unique site identifier. Required for clients serving multiple points of sale and forwarded onwards whilst using the qiwi payment method. |
| iban | Valid IBAN of consumer/destination account. |
| sequencetype | Sequence type of the direct debit. Possible values are: oneOff – The direct debit is executed once (default) first – First direct debit in a series of recurring ones |
| mandatereference | Mandate reference as returned on the first transaction in the sequence (found from mandatereference in checkoutDetails) |
| mandatesignaturedate | Date of the initial transaction. |
| bic | Valid BIC (8 or 11 alphanumeric letters) – optionally supplied to skip the bank selection page (by using the bank referenced by BIC as supplied) |
| clientip | Optional IP address of the consumer during checkout using Trustly (127.0.0.1 is not allowed!) |
| address | Customer’s billing address[6][6] |
| city | Customer’s billing city[6][7] |
| phone | Customer’s phone[6][6] |
| mobilephone | Customers mobile phone[6][7] |
| dob | MCC 6012 Date of Birth[6][6] |
| dynamicdescriptor | Statement narrative[6][7] |