Payment instrument verification

Overview

Payment instrument verification is a payment type in which the customer card or account is validated by either transferring a dummy (zero) amount from customer to merchant or by authorizing a specific amount (non-zero) on the customer's card or account and then voiding the transfer or the authorization. The authorization amount can be changed on merchant's request. Normally, the authorized amount is released shortly after the operation, but in some instances the authorized amount can be held up to 45 days.

This payment type can be used, for example, for registering COF purchases.

Restriction: For information about the availability of payment instrument verification, contact the ecommpay account manager.

Payment model

You initiate the verification by sending the account verification request to the payment platform or by opening the payment for in the card_verify mode. Once the payment platform receives the request, it creates an account verification operation.

Payment instrument verification may require the merchant to send additional requests:

  • If the payment requires customer to be authenticated by using the 3‑D Secure service, the payment platform sends to the web service a callback with the data required to generate a request to the issuer and suspends payment processing until the information about the authentication result is received. For this, in case of working via Gate, it is required to send a request with the authentication result—3ds_result, while in case of working via Payment Page, all actions are carried out without the merchant's web service involved.
  • If any payment stakeholder requests additional information (for example, the payment system may request cardholder address which was missing from the initial request.), the payment platform sends to the web service a callback that lists the requested parameters and suspends the purchase processing until the required information is received. In case of working via Gate, a request should be sent with the needed information included—clarification, while in case of working via Payment Page, all actions are carried out without the merchant's web service involved.

Figure: State diagram for payment instrument verification

The rest of this section describes any possible statuses of a payment instrument verification and related operations. More information about processing payment instrument verification is provided in the Payment Page and Gate sections.

Payment statuses

The following table describes the statuses of payment instrument verification.

error Error occurred when request processing. Payment is not performed. Final status. The request can be resent with the same payment identifier and the same payment can be retried.
processing Payment is being processed. Intermediate status
awaiting 3ds result Payment processing is suspended until the information about the 3‑D Secure authentication result is received. If this information is not received within the required timeout time, then the payment status is set to decline. Normally, the timeout is 30 minutes, but it may differ depending on a provider. For more information about specific timeouts, contact technical support at support@ecommpay.com. Intermediate status
awaiting clarification Payment processing is suspended until the required additional information is received. If the information is not received within 30 minutes, the payment is assigned the decline status Intermediate status
decline Payment could not be completed. Final status
success Payment has been completed. Final status. Additionally the payment refund is supported.

The account verification operation statuses

The following table describes the statuses of any account verification operation.

processing Operation is being processed. Intermediate status
awaiting 3ds result Payment processing is suspended until the information about the 3‑D Secure authentication result is received. If this information is not received within the required timeout time, then the payment status is set to decline. Normally, the timeout is 30 minutes, but it may differ depending on a provider. For more information about specific timeouts, contact technical support at support@ecommpay.com. Intermediate status
awaiting clarification Payment processing is suspended until the required additional information is received. If the information is not received within 30 minutes, the payment is assigned the decline status Intermediate status
decline Operation could not be completed. Final status
success Operation has been completed. Final status