卡支付接口

适用于：信用卡的预授权和直接购买

此接口适用于用户在商户页面输入卡信息，而不是跳转YabandPay托管页面输入卡信息，特别注意：

1、若商户已获得 PCI DSS 认证，具备安全处理持卡人信息的能力，可自行创建用于收集卡信息的表单，并通过参数cardinfo 提交数据。

2、若商户使用 YabandPay 提供的前端插件收集用户卡信息（可联系 YabandPay 获取集成方式），插件将返回一个一次性加密的 payment_token_object，可用于后续发起支付请求。

[!TIP|style:flat]

预授权有效期有30天，超过30天预授权订单将自动过期。

API URL：https://mapi.yabandpay.com/Payments

Method：POST

POST data type：Json

• 参数

签名示例：

拼接为URL方式并排序后的字符串

”3ds_initiate=01&amount=0.1&cardinfo={"card_holder":"John Smith","card_number":"4356789012345670","expiration_month":"01","expiration_year":"2023","cvc":"123"}&currency=EUR&description=test&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1756878556&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&sca_exemption=LowValue&sub_pay_method=Card&time=1756878556&timeout=0&user=016683“

提交示例cardinfo内容提交：

{
    "user": "016683",
    "sign": "63a5616e1d02f60f8e3155b783f428040467690dcb75aa6daee8118b5225332f",
    "method": "v3.CreateCardPayments",
    "time": 1756878556,
    "data": {
        "description": "test",
        "3ds_initiate": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Card",
        "operation": "11",
        "order_id": 1756878556,
        "cardinfo": "{\"card_holder\":\"John Smith\",\"card_number\":\"4356789012345670\",\"expiration_month\":\"01\",\"expiration_year\":\"2023\",\"cvc\":\"123\"}",
        "sca_exemption": "LowValue",
        "amount": "0.1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"
    }
}

提交示例payment_token_object内容提交：

{
    "user": "016683",
    "sign": "dde28b1765b4629ef1a7a0047e0ae9e7084b91eb1dd2d1e59c578c8badca4c5b",
    "method": "v3.CreateCardPayments",
    "time": 1720680417,
    "data": {
        "payment_token_object": "4564sf65as4f5awe4ft65awe4gt65ewaa4t65ew4t65ew4t65rew4t",
        "description": "test",
        "3ds_initiate": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Card",
        "operation": "1",
        "order_id": "203040950640690239603690",
        "amount": "1",
        "currency": "EUR",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "203040950640690239603690",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "1.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
        "state": "processing"
    },
    "message": "",
    "response_id": "202407111544200649155078"
}

更多信息：

返回结果：

1. 若调用成功，则返回"status": true

2. 若调用失败，则返回"status": false

你需要跳转返回的url。用户在此url完成3DS后，会同步跳转回redirect_url。我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态，以确保支付信息的实时准确性。 a) 如果订单状态state为paid，即支付成功； b) 如果订单状态state为authorized，即预授权成功。 预授权成功后如需要请款调用预授权请款接口。

返回代码：