Overview

Pre-Authorization is a process where a cardholder’s funds are temporarily held (frozen) at the time of the transaction without actually charging the card. The actual charge (Capture) is performed later when the transaction is fulfilled, or the hold can be released (Void) if no payment is required.

Pre-Authorization Trigger Methods

1. Merchant-controlled pre-authorization: The merchant explicitly specifies whether to use pre-authorization in the request parameters, allowing full control over the transaction type.
2. Oceanpayment-controlled pre-authorization: Oceanpayment automatically determines whether to perform pre-authorization based on the transaction scenario and risk control policies, without requiring additional parameters from the merchant.

Merchant-controlled pre-authorization

The merchant specifies the transaction type when calling the payment API by using the ET_NOTES parameter. Oceanpayment processes the transaction as a pre-authorization based on this value.

Parameter	Type	Length	Required	Description
ET_NOTES	string	1-100	Required	pre: Pre-Authorization sale: Sale

Oceanpayment automatic pre-authorization

Oceanpayment automatically determines whether pre-authorization is required based on the rules of the payment channel.

Pre-Authorization Status

You can determine whether the order has entered the pre-authorization state from the payment result.

Parameter	Description
payment_status	Payment result -1: Pending – the transaction is not final. Wait for async notification or query the latest status. 0: Failed / Cancelled – the payment did not complete. 1: Successful – fulfill the order and provide goods or services.
payment_authType	Type of payment for the order 0: Sale (standard transaction) 1: Pre-authorization, non-3D 2: 3D Secure, non-pre-authorization 3: 3D Secure with pre-authorization

Authorization Operations

When an order enters the pre-authorization state, you can use the Authorization Operations feature to capture or void the authorization.