跳转至

3DS支付验证

Liquido支持信用卡3DS支付验证，以下是目前支持的国家。

国家 是否支持
墨西哥
巴西

3DS支付验证流程

支付流程为Direct时

  1. 在信用卡支付的请求体中，加入card3dsInfo对象。设置use3ds字段的值为true，开启3DS支付验证。设置merchantSite3ds为您希望用户验证结束后跳转到的URL，方便用户查看支付状态。
  2. Liquido在收到请求后会返回支付状态为IN_PROGRESS的响应，您可以在transferDetails.card.card3dsInfo下找到threeDsRedirectUrl字段。
  3. 跳转至threeDsRedirectUrl，让付款人完成3DS认证流程，认证成功后，支付的状态会转为SETTLED。

创建带3DS支付验证的请求

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "DIRECT",
    ...  # other basic request fields
    "card3dsInfo": {
        "use3ds": true,
        "merchantSite3ds": "https://www.liquido.com"
    },
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "DIRECT",
    ...  # other basic response fields
    "transferDetails": {
        "card": {
            "cardInfo": {
                ... # card info fields
            },
            "card3dsInfo": {
                "use3ds": true,
                "merchantSite3ds": "https://www.liquido.com",
                "threeDsRedirectUrl": "https://3ds-redirect.liquido.com/15896579-b77e-4412-a3b3-aa1c5bcce0d6"
            }
        }
    },
    "transferStatus": "IN_PROGRESS",
    ...  # other basic response fields
}

支付流程为Redirect时

  1. 在信用卡支付的请求体中，加入card3dsInfo对象并设置use3ds字段的值为true。
  2. Liquido在收到请求后会返回支付状态为IN_PROGRESS的响应，您可以找到找到redirectUrl字段。
  3. 跳转至redirectUrl，让付款人完成3DS认证流程的支付，成功后支付的状态会转为SETTLED。

创建带3DS支付验证的请求

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}
Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "REDIRECT",
    ...  # other basic request fields
    "card3dsInfo": {
        "use3ds": true
    },
    ...  # other basic request fields
}
Response
{
    "transferStatusCode": 200,
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "REDIRECT",
    ...  # other basic response fields
    "transferDetails": {
        "card": {
            "card3dsInfo": {
                "use3ds": true
            }
        }
    },
    "redirectUrl": "https://www.redirect-qa.liquido.com?uid=0f9d857f-920a-4429-a772-93add007f56c",
    "transferStatus": "IN_PROGRESS",
    ...  # other basic response fields
}
回到页面顶部