面对面付款

专为线下实体场景设计，通过智能POS终端、扫码设备或移动App完成收款。

• ✔️ 专为线下场景设计的支付解决方案
• ✨️ 让线下收款变得简单高效
• 🔎 支持主扫、被扫等多种支付方式

开始集成 →

开始之前

注意

面对面付款方案只支持微信、支付宝线下场景支付方式。

集成方式

我们有两种面对面付款方式，选择您合适的方式进行集成：

• 商户扫码消费者
• 消费者扫码商户

工作原理

1. 集成Oceanpayment的线下支付到您的POS系统或收银App中；

商户扫码消费者

流程图

2. 通过调用扫描客户的付款码（主扫），将支付授权码pay_accountNumber传给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处理支付请求并返回支付结果。

消费者扫码商户

流程图

2. 通过请求Oceanpayment支付返回收款码QR Code链接，

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. 将返回的收款码参数pay_barCode转换为QR Code二维码，被客户扫描（被扫）：

<?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处理支付请求并返回支付结果。

处理返回

<?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>

• 您也需要通过noticeUrl获取交易的异步通知。
• 查看付款状态说明。

签名

查看详细的签名和验签功能。

API参考

👉即刻探索我们的。