One-time one-step purchase

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.

The payment workflow

You initiate one-step purchase by sending a sale request to the payment platform. Once the payment platform receives the request, it creates a sale operation which eventually results in debiting the customer card or account.

A one-step purchase may require the merchant to send the following additional requests:

  • If the payment requires customer to be authenticated by using the 3-D Secure technology, the payment platform sends to the web service a callback that contains the data required to generate a request to the issuer, suspends the purchase processing, and waits until the web service submits a 3ds_result request with the authentication results.
  • If the payment requires customer to be authenticated by the payment system on merchant's request, the payment platform receives a callback from the payment system and sends to the web service a callback with notification that authentication is required, and then suspends the payment processing and waits until the web service submits the following two merchant_auth requests: the start request—after customer confirms payment and finish—after customer enters validation code.
  • 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, suspends the purchase processing, and waits until the web service submits a clarification request with the requested information.

If the payment method supports refunds, after completing a one-time one-step purchase you can return your customers their money, if needed. You initiate a refund by sending a refund request to the payment platform. Refund is performed by using one of the following operations:

  • 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.

Figure: 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 how to perform one-time one-step purchases with payment cards, see One-step purchase. For more information about how to perform one-time one-step purchases by using alternative payment instruments, see Payments by using alternative methods.

Payment statuses

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

error Error occurred when request processing. Payment is not performed. Final status. The request can be resent with the same payment identifier.
processing Payment is being processed. Intermediate status
awaiting 3ds result Payment processing is suspended until the web service submits a 3ds_result request with the 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 web service submits a merchant_auth request—if the payment requires customer to be authenticated by the payment system on merchant's request—with the type parameter that is set to finish. 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 web service submits a clarification request—to continue the payment processing—with the required data. If the payment platform does not receive this request within 30 minutes, the status is set to decline. Intermediate status
awaiting customer

Payment processing is suspended until one of additional attempts to perform this payment is successfully completed—the status is set to success—or the maximum amount of the additional attempts has been exceeded—the status is set to decline.

For more information about the Try again payments, see Try Again button: retry to perform payment.

Intermediate status
decline Payment could not be completed. Final status
success Payment has completed successfully. Final status. Additionally the payment refund is supported.
partially paid The payment with the split amount was partially performed by one of the sale operations Final status. Additionally the payment refund is supported.
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.
reversed The total amount of payment was returned to a customer on the same business day the initial payment had been completed. 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 web service submits a 3ds_result request with the 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 web service submits a merchant_auth request—if the payment requires customer to be authenticated by the payment system on merchant's request—with the type parameter that is set to finish. 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 web service submits a clarification request—to continue the payment processing—with the required data. If the payment platform does not receive this request 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 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 web service submits a clarification request—to continue the payment processing—with the required data. If the payment platform does not receive this request 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

Related links