Authorization only

Some merchants may use a third-party Authentication provider and perform the authorization with EVO Cloud. In this case, you can submit a payment request to EVO Cloud with authentication data from the third-party 3D Secure provider.

Step 1: Perform the authentication with 3rd-party Authentication provider

Follow your existing integration process with third-party Authentication provider to get the authentication data required in the next step.

Step 2: Make a payment

With the authentication data from the third-party Authentication provider collected, you can make an HTTP POST request from your server to EVO Cloud endpoint

/g2/v1/payment/mer/{sid}/payment,

and specify the parameters below.

Parameter	Required	Description
`authentication.threeDS.mpiData`	O	The 3D Secure authentication data, required if the user goes through 3D Secure authentication.
`authentication.securePlus.securePlusData`	O	The SecurePlus authentication data, required if the user goes through SecurePlus authentication.

Details about authentication.threeDS.mpiData Object

authentication.threeDS.mpiData.eci: The electronic commerce indicator, required.

authentication.threeDS.mpiData.cavv: The CAVV value, required.

authentication.threeDS.mpiData.dsTransID: The directory server transaction ID, required if the user goes through 3D Secure 2 authentication.

authentication.threeDS.mpiData.threeDSVersion: The 3D Secure version, required if the user goes through 3D Secure 2 authentication. The current version that EVO Cloud supports is 2.1.0.

Details about authentication.securePlus.securePlusData Object

authentication.securePlus.securePlusData.eci: The raw result of the authentication returned from UnionPay to indicate the security status of this transaction, required.

authentication.securePlus.securePlusData.vcode: The verification code received from UnionPay, required.

Here is an example of sending a payment request to EVO Cloud with 3D Secure 2 authentication data get from a third-party provider:

Your will receive the response containing result.code to indicate the result. Here is an example of a successful payment response:

Step 3: Present the result

Use the result.code and payment.status to inform the user of the payment status. See the Appendix in the EVO Cloud API Specification for more details.

Result Code	Description
`S0000`	Success

For other possible result.code values and recommended messages that you can present to your user, see the Appendix in the EVO Cloud API Specification.

If the result.code is S0000, you need to check the payment.status to determine and inform your user of the payment status.

Status	Description
Authorised	Used for card transactions; means the transaction authorization is successfully completed and pending for capture (merchant can submit cancel).
Captured	If a card transaction, means transaction authorization and capture are successfully completed; if an e-wallet transaction, means the transaction is successfully completed.
Failed	Payment failed.

For other possible payment.status values and their descriptions, see the payment.status section in the EVO Cloud API Specification.

Step 1: Perform the authentication with 3rd-party Authentication provider#

Step 2: Make a payment#

Step 3: Present the result#

Step 1: Perform the authentication with 3rd-party Authentication provider

Step 2: Make a payment

Step 3: Present the result