In-Person Payments

Accept payments in physical locations Designed for offline, in-store scenarios. Collect payments using smart POS terminals, QR code scanners, or mobile cashier apps.

• ✔️ Built specifically for in-person payment scenarios
• ✨️ Simple and efficient offline payment experience
• 🔎 Supports multiple QR payment modes, including customer-presented and merchant-presented codes

Get Started →

Before You Star

Note

In-person payments currently support WeChat Pay and Alipay offline payment methods only.

Integration Options

Oceanpayment supports two in-person payment models. Choose the option that best fits your business flow:

• Merchant scans customer code
• Customer scans merchant code

How It Works

1. Integrate Oceanpayment offline payments into your POS system or cashier application.

Merchant scans customer code

Payment Flow Overview

2. When you scan the customer’s payment code (customer-presented mode), send the payment authorization code pay_accountNumber to Oceanpayment.

cURL -X POST 'https://test-secure.oceanpayment.com/gateway/directservice/pay' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'noticeUrl=https://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=USD' \
-d 'order_amount=0.01' \
-d 'methods=' \
-d 'order_notes=' \
-d 'billing_firstName=test' \
-d 'billing_lastName=test' \
-d 'pay_accountNumber=123456789' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=US' \
-d 'billing_state=AL' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \

3. Oceanpayment processes the request and returns the payment result.

Customer scans merchant code

Payment Flow Overview

2. The Oceanpayment payment request returns a QR code link.

curl -X POST 'https://secure.oceanpayment.com/gateway/directservice/pay' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'account=995149' \
-d 'terminal=99514901' \
-d 'signValue=6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b' \
-d 'noticeUrl=http://www.abc.com/notice.php' \
-d 'order_number=NO12345678' \
-d 'order_currency=USD' \
-d 'order_amount=0.01' \
-d 'methods=WeChatPay_Offline' \
-d 'order_notes=' \
-d 'billing_firstName=Vergil' \
-d 'billing_lastName=Pan' \
-d 'billing_email=test@gmail.com' \
-d 'billing_phone=13800138000' \
-d 'billing_country=US' \
-d 'billing_state=AL' \
-d 'billing_city=Washington D.C.' \
-d 'billing_address=705A big Road' \
-d 'billing_zip=529012' \
-d 'billing_ip=127.0.0.1' \
-d 'ship_firstName=Vergil' \
-d 'ship_lastName=Pan' \
-d 'ship_email=test@gmail.com' \
-d 'ship_phone=13800138000' \
-d 'ship_country=US' \
-d 'ship_state=AL' \
-d 'ship_city=Washington D.C.' \
-d 'ship_addr=705A big Road' \
-d 'ship_zip=529012' \
-d 'productNum=1' \
-d 'productName=Red Dress' \
-d 'productSku=#001' \
-d 'productPrice=0.01' \

3. The returned payment code parameter pay_barCode is converted into a QR code, which is then scanned by the customer.

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <notice_type>transaction</notice_type>
    <push_dateTime>2024-05-06 10:15:51</push_dateTime>
    <account>995149</account>
    <terminal>99514901</terminal>
    <signValue>5CF2E48721069E4E8C77A063FE8B348319C14A5EBA6956444902AE6BDB97F2D1</signValue>
    <methods>WeChatPay_Offline</methods>
    <order_number>NO12345678</order_number>
    <card_country></card_country>
    <order_currency>USD</order_currency>
    <order_amount>0.01</order_amount>
    <order_notes></order_notes>
    <card_number></card_number>
    <card_type></card_type>
    <payment_country></payment_country>
    <payment_id>240506101548268260914</payment_id>
    <payment_authType>0</payment_authType>
    <payment_status>-1</payment_status>
    <payment_details></payment_details>
    <payment_solutions></payment_solutions>
    <payment_risk></payment_risk>
    <payment_amount></payment_amount>
    <payment_exchangeRate></payment_exchangeRate>
    <customer_id></customer_id>
    <subscribe></subscribe>
    <pay_bankCode></pay_bankCode>
    <pay_barCode>2024050622001432901441897816</pay_barCode>
    <pay_userId>137****8623</pay_userId>
</response>

4. Oceanpayment processes payment requests and returns payment results.

Processing Return

<?xml version="1.0" encoding="UTF-8"?>
<response>
    <notice_type>transaction</notice_type>
    <push_dateTime>2024-05-06 10:15:51</push_dateTime>
    <account>995149</account>
    <terminal>99514901</terminal>
    <signValue>5CF2E48721069E4E8C77A063FE8B348319C14A5EBA6956444902AE6BDB97F2D1</signValue>
    <methods>WeChatPay_Offline</methods>
    <order_number>NO12345678</order_number>
    <card_country></card_country>
    <order_currency>USD</order_currency>
    <order_amount>0.01</order_amount>
    <order_notes></order_notes>
    <card_number></card_number>
    <card_type></card_type>
    <payment_country></payment_country>
    <payment_id>240506101548268260914</payment_id>
    <payment_authType>0</payment_authType>
    <payment_status>1</payment_status>
    <payment_details>80000:Transaction Approved</payment_details>
    <payment_solutions></payment_solutions>
    <payment_risk></payment_risk>
    <payment_amount></payment_amount>
    <payment_exchangeRate></payment_exchangeRate>
    <customer_id></customer_id>
    <subscribe></subscribe>
    <pay_bankCode></pay_bankCode>
    <pay_barCode>2024050622001432901441897816</pay_barCode>
    <pay_userId>137****8623</pay_userId>
</response>

• You also need to retrieve asynchronous transaction notifications via noticeUrl.
• Refer to the payment status documentation for details.

Signature Verification

Refer to the Signature & Verification section to learn how to sign your requests and validate the responses.

API Reference

👉Get started with our explore it now!