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.

Payment model

To initiate one-step purchase, a request of the sale category should be sent to the platform or the payment form should be opened in the Purchase mode with the sale payment type specified. Once the payment platform receives the request, it creates the 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:

  • Customer authentication by using the 3‑D Secure technology. In case of working via Gate, for such authentication, the web service is required to accept the corresponding callback and perform the needed actions, while in case of working via Payment Page, all actions needed for authentication are carried out without the web service involved.
  • Submission of additional payment information for any party involved in the payment processing. In case of working via Gate, for submitting additional information, the web service is required to accept the corresponding callback and send a request with the needed data, while in case of working via Payment Page, all actions needed for that are carried out without the web service involved.

After completing a one-time one-step purchase you can return your customers their money if needed. This can be done as a result of a request sent via Gate or as a result of the corresponding action in the tab of the needed purchase in the Dashboard interface. For a refund, depending on the refund time and amount and the payment instrument used for the payment, one of the following operations is initiated:

  • reversal if the refund is initiated within the operation day regardless of the purchase amount for a Mastercard card and provided that the total purchase amount is refunded for a card of any other card network;
  • refund if the refund is initiated for a card of any card network after operation day and regardless of the amount and within the operation day provided that a partial purchase amount is refunded for a card of all card networks except Mastercard.
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. More information about processing one-time one-step purchases provided in the Payment Page and Gate sections.

Payment statuses

The following table describes the statuses of a 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 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. For more information about specific timeouts, contact technical support at support@orchid.works. 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
awaiting customer

Payment processing is suspended until one of additional attempts to perform this payment is completed (in this case, the status is set to success or all additional attempts are used up (in this case, the 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 been completed. Final status. Additionally the payment refund is supported.
partially reversed Payment amount is partially refunded within the operation day on which the payment was completed. Final status
reversed Total payment amount is refunded within the operation day on which the payment was completed. Final status. Additionally, the refund can be cancelled.
partially refunded Partial amount of the payment is returned to the customer. Final status. Additionally, the refund can be cancelled.
refunded Payment amount is fully refunded after the operation day on which the payment was 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, the refund can be cancelled.

Statuses of the sale operation

The following table describes the statuses of the sale 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. For more information about specific timeouts, contact technical support at support@orchid.works. 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

Statuses of the reversal and refund operations

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

processing Operation is being processed. 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