Payment
Payment
POST Payment interface to initiate the payment. Once EVO Cloud has processed the request, you will receive the payment result.1.
Payment interface, you need to include, but not limited to, the following parameters. For field details, refer to the API documentation:paymentMethod.type: Filed that indicates the transaction type.paymentMethod.card: Object contains the shopper's card information. Mandatory when paymentMethod.type is card.paymentMethod.token.value: Filed that contains the token of your shopper. Mandatory when paymentMethod.type is token.transAmount: Object contains the currency and value of the payment.transInitiator: Object that contains the shopper's device type.authentication.authenticationOnly: The filed used to indicate the request is only get authentication(3DS, Secureplus) result or not.authentication.authenticationMethod: The filed to indicate the authentication way when this transaction need to authorise.authentication.authenticationType: The filed used to indicate the authentication type.2.
payment.status field in the EVO Cloud response. If the value is Captured, Authorised, or Capturing (depending on the value of the captureAfterHours field), then the transaction was successful. Otherwise, check result.code and result.message for the reason for the transaction failure.TIP
captureAfterHours and payment.status is as follows:| captureAfterHours | payment.status | Explanation |
|---|---|---|
| 0 | Captured | Payment successful, no further action needed; the transaction will be settled. |
| 1 - 168 | Capturing | Authorization successful; delayed settlement in progress. The transaction will be settled after the delay period ends, and you can also trigger settlement early by calling the POST Capture interface. |
| None | Authorised | Authorization successful; you need to manually call the POST Capture interface to trigger settlement. |
3.
GET Payment to query the transaction result. When you receive the query response, you should also determine the transaction result based on the payment.status field, using the same method as in Step 2. If the transaction fails, you can refer to payment.failureCode and payment.failureReason to understand the reason for the failure.4.
webhook in your POST Payment request and the transaction payment.status is Captured, Authorised, or Capturing, you can also receive the transaction result through asynchronous notifications, where the eventCode will be Payment. Again, you should determine the transaction result based on the payment.status field, using the same method as in Step 2.5.