The doAuthorization function performs a debit authorization request to authorization server of your acquirer.
Simple authorization and / or immediate payment
It is a payment with a payment.mode to CPT, you realize either an authorization + validation with an action code "101", or an authorization with an action code "100", and the validation is done either in automatic by Payline payment solution, either by merchant, using the webservice calls or via our back office tool Payline Administration Center.
NOTE : With a debit authorization, you have up to 7 days to validate the payment request. Afterwards 7 days, your authorization expires and becomes disabled.
Deferred payment
This is an automatically scheduled payment. The merchant calls a request for authorization and payment validation for delivery.
Authorization is valid for 7 days.
That validation can be done either automatically via Payline or by merchant using either the batch interface functionality, or by calling the doCapture service or via the administration center.
To debit your customer, you must fill the fields payment.action with "100", payment.mode with DIF and differedActionDate with payment date.
The validation date must respect the following constraint: differedActionDate <= autorizationDate + 6 .
Request
Extrait |
---|
Element | Description | Required | Format | Condition | version | Version of Payline web services. To be valued with the latest version: see the table of versions.
| Yes | N2 |
| payment | Payment Information. | Yes | Object payment |
| bankAccountData | Bank account information. | Yes | Object bankAccountData |
| card | Card Information. | Yes | Object card |
| order | Order information. | Yes | Object order |
| buyer | Buyer information. | No | Object buyer |
| owner | Owner information. | No | Object owner |
| privateDataList | Personal information. | No | Object PrivateDataList |
| authentication3DSecure | 3DSecure operations information. | No | Object authentication3DSecure |
| media | Detection of the media used during the payment. The possible values of this tag are: - Computer - Mobile - Tablet - TV - Console - Undefined. | No | AN25 |
| subMerchant | Payment Facilitator Information. | No | Object subMerchant |
| asynchronousRetryTimeout | For Asynchronous Retry function , a numeric that specifies the period in minutes. It must be between 5 and 10080 (7 days). | No | AN |
| linkedTransactionID | In case of installment, recurring or split shippment payment refers to the first authorization. | No | AN200 | Version 21 or higher (3DSV2) | transient | Data to populate the 3DSV2 container. Fetch the value of the last verifyEnrollmentResponse. | No | Java = String (100 K Octets) et SQL = CLOB | Version 21 or higher (3DSV2) | threeDSinfo | Information specific to 3DS authentication. | No | Object threeDSInfo |
| travelFileNumber | Transfer file reference (PLBS). | No | AN15 |
| recurring | Recurring or installment information. | No | Object recurring | Version 21 or higher (3DSV2) |
|