跳转至

重定向支付

重定向支付

向 Liquido 发送请求时,您应该将 paymentFlow 指定为 REDIRECT

HTTP请求

POST /v1/payments/charges/card

Request Headers
{
    "Content-Type": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "x-api-key": "{{api_key}}"
}

使用card info创建一个信用卡重定向支付

Request Body
{
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab9",
    "amount": 100,
    "currency": "BRL",
    "country": "BR",
    "paymentMethod": "CREDIT_CARD",
    "paymentFlow": "REDIRECT",
    "payer": {
        "name": "username",
        "email": "username@liquido.com",
        "document": {
            "documentId": "53023315540",
            "type": "CPF"
        },
        "phone": "+55 81987654321",
        "billingAddress": {
            "zipCode": "04849333",
            "state": "SP",
            "city": "sao paulo",
            "district": "Jardim Gaivotas",
            "street": "Rua 9 de setembro",
            "number": "15",
            "complement": "casa",
            "country": "BR"
        }
    },
    "orderInfo": {
        "orderId": "test-order-id",
        "shippingInfo": {
            "name": "shipping test name",
            "phone": "shipping phone",
            "email": "thiago@example.com",
            "address": {
                "street": "street name",
                "number": "building number",
                "complement": "unit, apt, etc.",
                "district": "district, neighborhood, etc.",
                "city": "city name",
                "state": "state, state code",
                "zipCode": "zip code, postal code",
                "country": "BR"
            }
        }
    },
    "description": "this is a test pay",
    "callbackUrl": "https://api.client.com/callback/",
    "subMerchantId": "UUID",
    "merchantRedirectInfo": {
        "merchantPageUrl": "https://www.merchantpageexample.com/123456"
    }
}

Content-Type: application/json
{
    "transferStatusCode": 200,
    "paymentFlow": "REDIRECT",
    "idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab9",
    "referenceId": "1ec983fa-1a37-679b-809b-067861d87ab9",
    "paymentMethod": "CREDIT_CARD",
    "amount": 100,
    "currency": "BRL",
    "country": "BR",
    "finalAmount": 100,
    "finalCurrency": "BRL",
    "createTime": "2022-03-01 17:53:18 GMT-08:00",
    "finalStatusTime": "2022-03-01 17:53:18 GMT-08:00",
    "payer": {
        "name": "username",
        "email": "username@liquido.com",
        "document": {
            "documentId": "53033315550",
            "type": "CPF"
        },
        "phone": "+55 81987654321",
        "billingAddress": {
            "zipCode": "04849333",
            "state": "SP",
            "city": "sao paulo",
            "district": "Jardim Gaivotas",
            "street": "Rua 9 de setembro",
            "number": "15",
            "complement": "casa",
            "country": "BR"
        }
    },
    "transferStatus": "IN_PROGRESS",
    "transferDetails": {
        "card": {}
    },    
    "description": "this is a test pay",
    "callbackUrl": "https://api.client.com/callback/",
    "redirectUrl": "https://www.redirect.liquido.com?uid=cb2d0f2b-c28d-4201-a7c8-8d87be57bdf5",
    "subMerchantId": "UUID",
    "merchantRedirectInfo": {
        "merchantPageUrl": "https://www.merchantpageexample.com/123456"
    }
}

HTTP Headers 字段说明

Key Value
Authorization "bearer {{access_token}}"
x-api-key {{api_key}}

Request Body 字段说明

参数 必填 类型 描述
idempotencyKey String 商户系统创建的唯一ID, 长度不大于128个字节。
amount Long 收款金额,单位是货币最小粒度。如 1 = 0.01BRL
country String 国家编号国际缩写码,遵循ISO 3166-1 alpha-2 code标准, 如巴西BR
currency String 货币代码,如巴西BRL
paymentMethod String 交易方式,枚举值CREDIT_CARD
paymentFlow String 交易流程, 如 REDIRECT
payer JSON 买家个人信息。
capture Boolean 设置为false以创建一个信用卡预授权
installments Integer 分期付款次数. 不分期的时候请缺省该参数
orderInfo JSON 订单信息
description String 描述
callbackUrl String 接收交易状态变更通知的地址。接收post请求。
subMerchantId String 子商户ID。商户类型为PSP时必填。
merchantRedirectInfo JSON 重定向回商户页面的信息。
riskData JSON 支付的风险信息。MERCHANT_APP_NAMEMERCHANT_WEBSITE 在riskData中必须填一个。 请参考这里查看更多详情。

创建一个带风控信息的信用卡支付

请参考这里查看更多详情。

Response Body 字段说明

参数 类型 描述
transferStatus String 汇款状态,枚举值,"SETTLED", "FAILED", "IN_PROGRESS", "AUTHORIZED"
transferStatusCode Integer 此次交易的状态码, 200表示交易成功、进行中或预授权成功, 其他代表失败
referenceId String 此次交易的ID
idempotencyKey String 此参数用于幂等目的,交易的唯一标识ID 长度不大于128个字节。
amount Long 收款金额
country String 国家编码 BR
currency String 收款货币代码,长度为3个字节,BRL
finalAmount Long 用于创建收款订单的最终金额。对于需要转换汇率的收款订单,这个字段的值表示源请求金额被转换后的金额。
finalCurrency String finalAmount的收款货币代码
paymentMethod String 支付方式. 枚举值, CREDIT_CARD
paymentFlow String 支付流程. 枚举值, REDIRECT
payer JSON 付款人信息
transferDetails JSON 交易类型的详细信息
description String 描述信息
callbackUrl String 商户接收通知的回调地址. 接收http的get请求.
createdTime String 创建时间
finalStatusTime String 最终状态更新时间. 最终状态,包括"REFUNDED", "FAILED"
redirectUrl String 必须重定向客户以完成付款的 URL。
subMerchantId String 子商户ID。
merchantRedirectInfo JSON 重定向回商户页面的信息。

merchantRedirectInfo 对象字段说明

参数 必填 类型 描述
merchantPageUrl String 此URL是重定向回商户页面的URL。当您需要Liquido在用户完成支付后重定向用户回到您的页面时,您需要在请求中包含此内容。只有当请求参数中的‘paymentFlow’为‘REDIRECT’时,您才可以设置此重定向URL。
回到页面顶部