Overview

A secure and reliable pre-authorization payment feature that ensures fund safety while providing a flexible payment solution. It supports both capture and void of pre-authorized transactions.

Function

• Used to perform capture or void operations on a pre-authorized transaction.

Pre-Authorization Initiation Methods

Pre-authorization can be triggered in the following two ways.

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.

Authorization Management Methods

The following authorization methods are supported:

1. Authorization via API: Suitable for merchants with a large transaction volume or automated processing requirements. Merchants can submit Capture or Void requests directly through the API.
2. Authorization via Merchant Portal: Merchants can log in to the Oceanpayment Merchant Portal and manually perform Capture or Void operations on pre-authorized transactions.

Flow Chart

Manual Capture or Void

1. The merchant server can perform Capture or Void operations on a pre-authorized transaction by setting the payment_authType parameter.

curl -X POST '/gateway/service/auth'
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'account=995149'
-d 'terminal=99514901'
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b'
-d 'payment_id=180803140041683010528'
-d 'payment_authType=1'

Resquest

Parameter	Type	Length	Required	Description
payment_authType	int	1	Required	Authorization action Capture or Void operation to be performed on a pre-authorized transaction. 1: Capture 2: Void

Response

<?xml version="1.0" encoding="utf-8"?>
<respon> 
  <account>995149</account>  
  <terminal>99514901</terminal>  
  <signValue>A75EBFFC5CF11EBBF752373115FD1CC1FF4472ACB338EF1E6F303594C656C3D0</signValue>  
  <order_number/>  
  <payment_id>240528151145313026060</payment_id>  
  <payment_status>1</payment_status>  
  <payment_details>Success</payment_details> 
</respon>

Authorization Result Type

Parameter	Description
payment_status	Operation result 1: Success 0: Failed
payment_details	Result details Code:Description

• View the complete list of authorization operation response parameters →
• The results of Capture and Void operations can also be received through asynchronous notifications.