获取Token（直接方式）

适用于：持有PCI DSS的商户和机构

通过此接口调用，完成一笔完整流程的支付（必须完成3DS校验） YabandPay将持卡人敏感数据转换成一串随机字符串（即Token）以去除身份信息。使用Token可以发起如下支付：

1. 用户可以在结账页面一键完成付款，无需输入信用卡信息。
2. 商户可以使用此Token来执行定期付款或订阅收费等。

[!TIP|style:flat] 使用流程

1. 激活Token。联系您的客户经理开通Token支付功能。

2. 用户授权。为消费者启用快捷支付（Token支付）时您有义务明确告知用户并获得授权，以避免可能的纠纷。

3. 获取Token。要获得Token，首先需要发起一个标准的信用卡交易，YabandPay将会返回url，用户通过该url完成3DS校验后，YabandPay将会通过异步通知返回Token，参数是payment_token_object。

4. 发起Token支付。请包含Token在变量payment_token_object中。如果Token校验正确，YabandPay将执行Token支付；如果Token校验失败，YabandPay将返回错误信息，这时建议重新通过发起此交易流程以获取Token并再次发起支付。

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","emial":"JohnSmith@gmail.com","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"

得到的 stringA 使用 secret_key做签名

得到的签名如下：

"89f7ab3caea19d5240f578bd2439da7205a5d6122ec34bc5ec0bf6872a449bf6"

提交示例：

{
    "user": "016683",
    "sign": "89f7ab3caea19d5240f578bd2439da7205a5d6122ec34bc5ec0bf6872a449bf6",
    "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\",\"emial\":\"JohnSmith@gmail.com\",\"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"
    }
}

返回示例：

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "1725875388",
        "trade_id": "2b2aa1af-6e97-4c01-8c52-86200bf66c82",
        "amount": "0.1",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/pay_method/Y3JlZGl0Y2FyZA==/MmIyYWExYWYtNmU5Ny00YzAxLThjNTItODYyMDBiZjY2Yzgy",
        "state": "processing"
    },
    "message": "",
    "response_id": "202409091749500451314672"
}

更多信息：

MIT & CIT :

MIT= Merchant Initiated subsequent transactions.由商户发起的Token扣款。

CIT= Cardholder Initiated Subsequent transactions.有用户参与的Token支付。 请在开通支付时候沟通好需要MIT还是CIT模式，做相应配置的开通

返回支付结果：

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

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

您需要跳转返回的url。用户在此url输入卡号信息并完成支付后，会同步跳转回redirect_url。我们强烈建议同时使用订单查询和异步通知来同步和更新支付状态，以确保支付信息的实时准确性。

返回Token：

1. 当用户同意授权并支付成功以后，YabandPay将通过异步通知返回payment_token_object；

2. 如果用户不同意授权或未完成支付，在异步通知中不将返回payment_token_object。

3DS低价值豁免：

在下列限额范围内的交易可被认定为低价值交易。当订单金额小于或等于以下金额时，经过批准可适用交易代码 02（低价值豁免）。

返回代码：