Page tree

 Request

Response


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


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


ownerOwner information.NoObject 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


subMerchantPayment Facilitator Information.NoObject subMerchant
asynchronousRetryTimeout

For Asynchronous Retry function , a numeric that specifies the period in minutes. It must be between 5 and 10080 (7 days).

NoAN
linkedTransactionIDIn case of installment, recurring or split shippment payment refers to the first authorization.NoAN200

Version 21 or higher (3DSV2)

transient

Data to populate the 3DSV2 container.

Fetch the value of the last verifyEnrollmentResponse.

NoJava = String (100 K Octets) et SQL = CLOB Version 21 or higher (3DSV2)

threeDSinfo

Information specific to 3DS authentication.NoObject threeDSInfo
travelFileNumberTransfer file reference (PLBS).NoAN15
recurringRecurring or installment information.No Object recurringVersion 21 or higher (3DSV2)