重定向支付
重定向支付
向 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_NAME 或 MERCHANT_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。 |