One-time one-step purchase

Notice: This article provides a general description of processing one-time one-step purchases in the ecommpay payment platform and covers information about operations utilised to execute a payment of this type and statuses that are assigned to the payment and the operations performed within it.

In addition, use the following materials to gain a fuller understanding of processing one-time one-step purchases:

Purchase processing—an article that covers processing one-time one-step purchases via Payment Page and describes requests and callbacks that are used in case of card payments.
articles of the Payment methods section containing a description of processing one-time one-step purchases via Payment Page with the focus on the specific features of the payment method used and information about relevant requests and callbacks.

Overview

One-time one-step purchase is a payment type which uses only one request to make a one-time transfer of funds from customer to merchant. This is the most basic purchase type in which the customer card or account is immediately debited for the amount of the purchase, for example to pay for an item of goods.

Payment model

To initiate one-step purchase, the purchase mode and the sale operation type must be used. When the customer confirms payment processing, the request is sent to the payment platform. Once the payment platform receives the request, it creates the sale operation which eventually results in debiting the customer card or account.

One-step purchase processing can involve auxiliary procedures: 3‑D Secure authentication, authentication on merchant's request, and/or providing additional payment information. These procedures do not require any additional actions on the side of the web service, but they usually require customer actions.

If the payment method supports the capability of confirming that the funds were transferred to the payment recipient, then, after the sale operation has been completed, the payment confirmation operation is initiated in the payment platform. It results in receiving such a confirmation from the provider.

If the payment method used for the purchase supports refunds, after completing a one-time one-step purchase the merchant can return the customers their money, if needed. Refund processing is initiated using Gate or Dashboard, and one of the following operations is performed:

reversal—this operation is used when refund is performed on the same day as the initial purchase.
refund—this operation is used when refund is performed after the business day of the initial purchase is closed.

In addition, the reversal operation is initiated automatically when the purchase is assigned the success status following the confirmation from the payment system or the provider, but the funds cannot be transferred to the payment recipient.

Figure 1. State diagram for one-time one-step purchase

The rest of this section describes any possible statuses of a one-time one-step purchase and operations related with the purchase. For more information about performing one-time one-step purchases, see Purchase processing. For more information about performing one-time one-step purchases depending on the payment method, see Methods.

Payment statuses

The following table describes the statuses of any one-time one-step purchase.


`error`	Payment processing is not initiated, error occurred when processing the request received by the payment platform.	Final status. Payment processing can be reinitiated.
`processing`	Payment is being processed.	Intermediate status
`awaiting 3ds result`	Payment processing is suspended until the payment platform receives the information about 3‑D Secure authentication result. If the payment platform does not receive this request 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 provider. For more information about specific timeouts, contact technical support at support@ecommpay.com.	Intermediate status
`awaiting merchant auth`	Payment processing is suspended until the payment platform receives the information about the result of the authentication on merchant's request.	Intermediate status
`awaiting redirect result`	Payment processing is suspended until the payment system submits a callback with the result to the payment platform. Depending on the result that the payment system submitted the status is set to `success` or `decline`. When processing of the payment only one of the following statuses can be used: either `awaiting redirect result` or `awaiting customer action`.	Intermediate status
`awaiting customer action`	Payment processing is suspended until a customer interacts with a payment system that submits the results of this interaction. Depending on the result that the payment system submitted the status is set to `success` or `decline`. When processing of the payment only one of the following statuses can be used: either `awaiting redirect result` or `awaiting customer action`.	Intermediate status
`awaiting clarification`	Payment processing is suspended until the payment platform receives the additional information from the customer (for more information, see Submission of additional payment information). If the payment platform does not receive the required information within 30 minutes, the status is set to `decline`.	Intermediate status
`awaiting confirmation`	Payment processing is suspended until the payment platform receives the confirmation from the payment system or the provider that the funds have been transferred to the payment recipient.	Intermediate status
`awaiting customer`	Payment processing is suspended until the payment data for retry attempt is received from the customer. When this data is received, the payment status is set to `processing`. When the customer has declined to repeat the attempt or the time limit for making the attempts has expired, the payment status is set to `decline` (for more information about the Try again payments, see: Payment retries).	Intermediate status
`decline`	Payment could not be completed.	Final status
`success`	Payment has completed successfully.	Final status. Additionally the payment refund is supported.
`partially reversed`	The partial amount of payment has returned to a customer.	Final status
`reversed`	The total amount of payment was returned to a customer on the same business day the initial payment had been completed.	Final status
`partially refunded`	The partial amount of payment has returned to a customer.	Final status. Additionally a partial refund can be cancelled.
`refunded`	The the total amount of payment was returned to a customer after the business day the initial purchase had been completed. This status is used if the total amount of payment is returned in one refund or if the total amount of the partial refunds is equal to the total amount of payment.	Final status. Additionally a refund can be cancelled.

The sale operation statuses

The following table describes the statuses of any sale operation.


`processing`	Operation is being processed.	Intermediate status
`awaiting 3ds result`	Operation processing is suspended until the payment platform receives the information about 3‑D Secure authentication result. If the payment platform does not receive this request 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 provider. For more information about specific timeouts, contact technical support at support@ecommpay.com.	Intermediate status
`awaiting merchant auth`	Operation processing is suspended until the payment platform receives the information about the result of the authentication on merchant's request.	Intermediate status
`awaiting redirect result`	Operation processing is suspended until the payment system submits a callback with the result to the payment platform. Depending on the result that the payment system submitted the status is set to `success` or `decline`.	Intermediate status
`awaiting customer action`	Operation processing is suspended until a customer interacts with a payment system that submits the results of this interaction. Depending on the result that the payment system submitted the status is set to `success` or `decline`.	Intermediate status
`awaiting clarification`	Operation processing is suspended until the payment platform receives the additional information from the customer (for more information, see Submission of additional payment information). If the payment platform does not receive the required information within 30 minutes, the status is set to `decline`.	Intermediate status
`decline`	Operation could not be completed.	Final status
`success`	Operation has completed successfully.	Final status

Statuses of the payment confirmation operation

The following table describes the statuses of the payment confirmation operation.


`processing`	Operation is being processed.	Intermediate status
`decline`	Operation could not be completed.	Final status
`success`	Operation has been completed successfully.	Final status

Statuses of the reversal and refund operations

The following table describes the statuses of any reversal or refund operation.


`processing`	Operation is being processed.	Intermediate status
`awaiting clarification`	Operation processing is suspended until the payment platform receives the additional information from the customer. If the payment platform does not receive the required information within 30 minutes, the status is set to `decline`.	Intermediate status
`decline`	Operation could not be completed.	Final status
`success`	Operation has completed successfully.	Final status