创建一个支付请求
创建一个信用卡支付
当向Liquido发送信用卡交易请求时,您需要提供信用卡的详细信息。您可以通过直接发送卡的详细信息或者cardId进行请求。 请参考如何创建cardId。
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-067861d87ab0",
"amount": 500,
"currency": "PEN",
"country": "PE",
"paymentMethod": "CREDIT_CARD",
"paymentFlow": "DIRECT",
"payer": {
"name": "username",
"email": "username@liquido.com",
"phone": "+51 1234567890",
"document": {
"documentId": "700254258",
"type": "DNI"
},
"billingAddress": {
"zipCode": "03400",
"state": "CDPE",
"city": "Álamos",
"street": "Simón Bolívar",
"number": "12121"
}
},
"card": {
"cardHolderName": "card_holder_name",
"cardNumber": "4242424242424242",
"expirationMonth": "06",
"expirationYear": "2029",
"cvc": "123"
},
"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": "PE"
}
}
},
"description": "this is a test pay",
"callbackUrl": "https://api.client.com/callback/",
"subMerchantId": "UUID"
}
使用card id创建一个信用卡支付
如何获得card id?
请参考这里 查看更多详情。
Request Body
{
"idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
"amount": 500,
"currency": "PEN",
"country": "PE",
"paymentMethod": "CREDIT_CARD",
"paymentFlow": "DIRECT",
"payer": {
"name": "username",
"email": "username@liquido.com",
"phone": "+51 1234567890",
"document": {
"documentId": "700254258",
"type": "DNI"
},
"billingAddress": {
"zipCode": "03400",
"state": "CDPE",
"city": "Álamos",
"street": "Simón Bolívar",
"number": "12121"
}
},
"cardId": "card_8736453a-dad0-4f26-85f0-95e8787d0237",
"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": "PE"
}
}
},
"description": "this is a test pay",
"callbackUrl": "https://api.client.com/callback/",
"subMerchantId": "UUID"
}
Response
{
"transferStatusCode": 200,
"transferErrorMsg": null,
"idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
"referenceId": "1ec983fa-1a37-679b-809b-067861d87ab0",
"paymentMethod": "CREDIT_CARD",
"amount": 500,
"currency": "PEN",
"country": "PE",
"finalAmount": 500,
"finalCurrency": "PEN",
"createTime": "2022-03-01 17:53:18 GMT-08:00",
"scheduledTime": "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",
"phone": "+51 1234567890",
"document": {
"documentId": "700254258",
"type": "DNI"
},
"billingAddress": {
"zipCode": "03400",
"state": "CDPE",
"city": "Álamos",
"street": "Simón Bolívar",
"number": "12121"
}
},
"transferDetails": {
"card": {
"cardInfo": {
"cardHolderName": "card_holder_name",
"expirationMonth": 6,
"expirationYear": 2029,
"bin": "424242",
"last4": "4242",
"brand": "VISA"
},
"cardId": "card_8736453a-dad0-4f26-85f0-95e8787d0237"
}
},
"transferStatus": "SETTLED",
"description": "this is a test pay",
"callbackUrl": "https://api.client.com/callback/",
"subMerchantId": "UUID"
}
通知 / 回调
Content-Type: application/json
{
"eventType": "CHARGE_SUCCEEDED",
"data": {
"chargeDetails": {
"transferStatusCode": 200,
"transferErrorMsg": null,
"idempotencyKey": "1ec983fa-1a37-679b-809b-067861d87ab0",
"referenceId": "1ec983fa-1a37-679b-809b-067861d87ab0",
"paymentMethod": "CREDIT_CARD",
"amount": 500,
"currency": "PEN",
"country": "PE",
"finalAmount": 500,
"finalCurrency": "PEN",
"createTime": "2022-03-01 17:53:18 GMT-08:00",
"scheduledTime": "2022-03-01 17:53:18 GMT-08:00",
"finalStatusTime": null,
"payer": {
"name": "username",
"email": "username@liquido.com",
"phone": "+51 1234567890",
"document": {
"documentId": "700254258",
"type": "DNI"
},
"billingAddress": {
"zipCode": "03400",
"state": "CDPE",
"city": "Álamos",
"street": "Simón Bolívar",
"number": "12121"
}
},
"transferDetails": {
"card": {
"cardInfo": {
"cardHolderName": "card_holder_name",
"expirationMonth": 6,
"expirationYear": 2029,
"bin": "424242",
"last4": "4242",
"brand": "VISA"
},
"cardId": "card_8736453a-dad0-4f26-85f0-95e8787d0237"
}
},
"transferStatus": "SETTLED",
"description": "this is a test pay",
"callbackUrl": "https://api.client.com/callback/",
"subMerchantId": "UUID"
}
}
}
HTTP Headers 字段说明
Key | Value |
---|---|
Authorization | "bearer" + " " + {{access_token}} |
x-api-key | {{api_key}} |
Request Body 字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
idempotencyKey | String | 商户系统创建的唯一ID, 长度不大于128个字节。 | |
amount | Long | 收款金额,单位是货币最小粒度。 金额最小 500 = 5PEN | |
country | String | 国家编号国际缩写码,遵循ISO 3166-1 alpha-2 code标准, 如秘鲁PE | |
currency | String | 货币代码,如秘鲁PEN | |
paymentMethod | String | 交易方式,枚举值CREDIT_CARD | |
paymentFlow | String | 交易流程, 如DIRECT 或 REDIRECT | |
payer | JSON | 买家个人信息 | |
card | JSON | 信用卡信息.如果cardId缺省,则card不能为缺省 | |
cardId | String | 卡id. 如果card缺省,则cardId不能为缺省 | |
capture | Boolean | 设置为false以创建一个信用卡预授权 | |
installments | Integer | 分期付款次数. 不分期的时候请缺省该参数 | |
orderInfo | JSON | 订单信息 | |
description | String | 描述 | |
callbackUrl | String | 接收交易状态变更通知的地址,接收post请求 | |
subMerchantId | String | 子商户ID。商户类型为PSP时必填。 | |
riskData | JSON | 支付的风险信息。MERCHANT_APP_NAME 或 MERCHANT_WEBSITE 在riskData中必须填一个。 请参考这里查看更多详情。 |
Payer 对象字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
name | String | 名字,全称 | |
String | 邮箱 | ||
phone | String | 电话号码,需包含“+51”的前缀。 | |
document | JSON | 支付人的身份信息 | |
billingAddress | JSON | 账单邮寄地址 |
Document 对象字段说明
Parameter | Required | Type | Description |
---|---|---|---|
documentId | String | 证件号码. | |
type | String | 证件类型.如DNI |
BillingAddress 对象字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
zipCode | String | 邮政编码 | |
state | String | 州 | |
city | String | 城市 | |
street | String | 街道 | |
number | String | 门牌号 |
OrderInfo 对象字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
orderId | String | 订单号 (字段仅当对象有被提供时必填) |
|
shippingInfo | JSON | 运输信息 |
ShippingInfo 对象字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
name | String | 名称 | |
phone | String | 电话号码,需包含“+51”的前缀。 | |
String | 邮箱地址 | ||
address | JSON | 地址信息,结构和billingAddress一致 |
Card 对象字段说明
参数 | 必填 | 类型 | 描述 |
---|---|---|---|
cardHolderName | String | 持卡人全称 | |
cardNumber | String | 卡号, 16位纯数字字符串,不能有横杠空格等分隔符 | |
expirationMonth | String | 信用卡有效期月份,2位数。 | |
expirationYear | String | 信用卡有效期年份,4位数。 | |
cvc | String | 信用卡安全码 |
Response Body 字段说明
参数 | 类型 | 描述 |
---|---|---|
transferStatus | String | 汇款状态,枚举值,"SETTLED", "FAILED", "IN_PROGRESS", "AUTHORIZED" |
transferStatusCode | Integer | 此次交易的状态码, 200表示交易成功、进行中或预授权成功, 其他代表失败 |
transferErrorMsg | String | 此次交易失败原因 |
referenceId | String | 此次交易的ID |
idempotencyKey | String | 此参数用于幂等目的,交易的唯一标识ID,长度不大于128个字节。 |
amount | Long | 收款金额 |
country | String | 国家编码 PE |
currency | String | 收款货币代码,长度为3个字节,PEN |
finalAmount | Long | 用于创建收款订单的最终金额。对于需要转换汇率的收款订单,这个字段的值表示源请求金额被转换后的金额。 |
finalCurrency | String | finalAmount的收款货币代码 |
paymentMethod | String | 支付方式. 枚举值, CREDIT_CARD |
payer | JSON | 付款人信息 |
transferDetails | JSON | 交易类型的详细信息 |
description | String | 描述信息 |
callbackUrl | String | 商户接收通知的回调地址. 接收http的get请求 |
createTime | String | 创建时间 |
scheduledTime | String | 执行时间 |
finalStatusTime | String | 最终状态更新时间. 最终状态,包括"REFUNDED", "FAILED" |
subMerchantId | String | 子商户ID。 |
TransferDetails 对象字段说明
参数 | 类型 | 描述 |
---|---|---|
card | JSON | 卡相关信息 |
Card (响应)对象字段说明
参数 | 类型 | 描述 |
---|---|---|
cardInfo | JSON | 卡详细信息 |
cardId | String | 卡ID, 使用卡信息支付时不返回,用卡ID支付时会返回 |
installments | Integer | 分期付款次数 |
CardInfo (响应)对象字段说明
参数 | 类型 | 描述 |
---|---|---|
cardHolderName | String | 持卡人姓名 |
bin | String | 卡号前6位数字 |
last4 | String | 卡号后4位数字 |
brand | String | 信用卡组织. 如 VISA, MASTERCARD |
expirationMonth | Integer | 1位数或者2位数的信用卡有效期月份。 |
expirationYear | Integer | 信用卡有效期年份,4位数。 |
支付状态
参数 | 描述 |
---|---|
IN_PROGRESS | 交易处理中 |
SETTLED | 交易完成 |
REFUNDING | 退款中 |
REFUNDED | 已退款 |
CHARGED_BACK | 拒付 |
FAILED | 交易失败,异常 |
Notification 事件类型
CHARGE_SUCCEEDED,
CHARGE_FAILED,
CHARGE_CHARGED_BACK,
CHARGE_REFUND_SUCCEEDED,
CHARGE_REFUND_FAILED;
更多的信用卡支付功能
创建一个卡ID付款的信用卡支付
请参考这里 查看更多详情。
创建一个信用卡预授权
请参考这里 查看更多详情。
创建一个3DS验证的信用卡支付
请参考这里 查看更多详情。
创建一个分期付款的信用卡支付
请参考这里查看更多详情。
创建一个带风控信息的信用卡支付
请参考这里查看更多详情。
创建一个重定向的信用卡支付
请参考这里查看更多详情。