跳到主要内容

概述​

其他本地支付的集成绑卡方式，可用于Alipay+等支付产品。

开始之前​

注意

集成之前，请先查看支持订阅扣款的本地支付方式清单。

工作原理​

  1. 设置请求头组：
'Content-Type:application/json',
'account:995149',
'terminal:99514901',
'secureCode:12345678'
  1. 调用Oceanpayment创建QuickPay ID，提交必要参数：
cURL -X POST 'https://checkout-s.oceanpayment.com/pg/quickPay/create' \
-d 
{
    "order": {
        "currency": "USD",
        "amount": "0.1",
        "methods": "{methods}",
        "redirectUrl": "http://www.abc.com/result.php",
        "notifyUrl": "http://www.abc.com/notice.php",
        "remark": "",
        "ip": "127.0.0.1",
        "description": ""
    },
    "merchant": {
        "referenceId": "test20250116094234"
    },
    "billing": {
        "firstname": "firstName",
        "lastname": "lastName",
        "email": "test@op.com",
        "phone": "13800138000",
        "country": "US",
        "state": "state",
        "city": "city",
        "address": "address",
        "zip": "518000"
    },
    "customer": {
        "id": "test20250116094234"
    },
    "device": {
        "environment": "",
        "osType": ""
    }
}

处理返回​

  1. url：跳转url地址，商户需要浏览器进行重定向，用户通过前端完成授权验证。
  • url不为空时：则表示需要进行页面重定向，通过前端完成授权验证，验证后会返回创建QuickPay ID的结果(返回依赖于redirectUrl，默认使用POST接收)；
  • url为空时：返回数据即为创建QuickPay ID的结果。
{
    "msg": "SUCCESS",
    "code": "000",
    "data": {
        "account": "995149",
        "terminal": "99514901",
        "order": {
            "methods": "Klarna",
            "referenceId": "250117093828061010584",
            "remark": "",
            "description": ""
        },
        "url": "https://checkout.oceanpayment.com/bank/quickPay/create?opRefId=250117093828061010584",
        "merchant": {
            "referenceId": "test20250117093730"
        }
    }
}
  • 商户将用户重定向到url地址进行创建 ：
HTTP/1.2 301 Moved Permanently
Location: {url}
  • 用redirectUrl参数来接收创建QuickPay ID的结果：
Array
(
    [code]=> 000
    [message] => SUCCESS
    [account] => 995290
    [terminal] => 99529001
    [signature] => F03C3D5154FC2672C5EC05BAD3DDDF0892617CC1517517DCD37E6499AA896D73
    [card_number] => 411111***1111
    [card_type] => USD
    [order_amount] => 0.01
    [order_notes] => 
    [card_number] => 
    [card_type] => null
    [card_country] => US
    [order_currency] => USD
    [order_amount] => 0.01
    [order_methods] => 
    [order_reference_id] => 250214134817000529042
    [order_remark] =>
    [merchant_reference_id] => 12345678
    [quickpay_id] => 6cdf6ebf-86c9-41ae-aee5-623ce3d48d22
    [quickpay_status] => 1
)
  1. 查看QuickPay ID的创建结果。
  2. 商户保存返回的卡信息quickpay_id，格式为UUID形式，用来发起快捷/订阅支付。

签名​

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

API参考​

👉即刻探索我们的。