Overview

Submit order, payment, and shipping information to customs for compliance with cross-border e-commerce import rules. Only orders with matching “three documents” are cleared.

Function Description

• Provide accurate basic information: Ensure that the registration information filed with customs for your e-commerce platform is accurately provided to Oceanpayment, as it is a critical field in the payment request message.
• Maintain order information consistency: The order information (especially the order number and amount) submitted to Oceanpayment must be consistent with the information in your internal system and the order information reported to customs.
• Data Window: Last 180 days.
• Supported Transactions: WeChat, Alipay, and UnionPay.

Flow Chart

Initiate Submission

1. The merchant server calls the customs submission function and sends the required parameters along with the customs code customs to Oceanpayment:
2. Split submissions can be performed using the sub_order_number.

curl -X POST '/gateway/service/customsUpload' \
-H 'Content-Type: application/x-www-form-urlencoded'
-d 'account=995149'
-d 'terminal=99514901'
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b'
-d 'payment_id=180806004457621010532'
-d 'type=1'
-d 'pay_userName=customs'
-d 'price=0.01'
-d 'total_amount=1'
-d 'customs=01'
-d 'customs_number=2012556842365'
-d 'customs_name=company'
-d 'sub_order_number=2012556842365-1'
-d 'shipping_fee=0.99'

Response Data

<?xml version="1.0" encoding="utf-8"?>
<response> 
  <account>995149</account>  
  <terminal>99514901</terminal>  
  <signValue>aecc5b6bbdba3e801cb3507dc8278cd9700d79d9bdd10d337691642c8e6e97ee</signValue>  
  <payment_id>240528151145313026060</payment_id>  
  <type>1</type>  
  <status>1</status>  
  <details>Success</details> 
</response>

Submission Result

Parameter	Description
tracking_results	Submission result code description

• View full list of customs submission response parameters →
• Once the submission is complete, the customs submission result should be received via asynchronous notifications.
• Each sub_order_number in a split submission will trigger an asynchronous notification for its submission result.