When sending a credit card payment request over to Liquido, the card information details need to be included. The card information details can be sent with card info or cardId.
See more about how to create a cardId.
Please contact the account manager if tax withholding is a requirement.
{"idempotencyKey":"1ec983fa-1a37-679b-809b-067861d87ab0","amount":10000,"currency":"COP","country":"CO","paymentMethod":"CARD","paymentFlow":"DIRECT","payer":{"name":"username","email":"username@liquido.com","document":{"documentId":"42212345678","type":"CC"},"phone":"+57 3123456789","billingAddress":{"zipCode":"111111","state":"Cundinamarca","city":"Bogotá","street":"Apartamento 502, Torre I","number":"Calle 34 # 56 - 78"}},"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":"CO"}}},"description":"this is a test pay","callbackUrl":"https://api.client.com/callback/","subMerchantId":"UUID"}
{"idempotencyKey":"1ec983fa-1a37-679b-809b-067861d87ab0","amount":10000,"currency":"COP","country":"CO","paymentMethod":"CARD","paymentFlow":"DIRECT","payer":{"name":"username","email":"username@liquido.com","document":{"documentId":"42212345678","type":"CC"},"phone":"+57 3123456789","billingAddress":{"zipCode":"111111","state":"Cundinamarca","city":"Bogotá","street":"Apartamento 502, Torre I","number":"Calle 34 # 56 - 78"}},"cardId":"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":"CO"}}},"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":"CARD","amount":10000,"currency":"COP","country":"CO","finalAmount":10200,"finalCurrency":"COP","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","document":{"documentId":"42212345678","type":"CC"},"phone":"+57 3123456789","billingAddress":{"zipCode":"111111","state":"Cundinamarca","city":"Bogotá","street":"Apartamento 502, Torre I","number":"Calle 34 # 56 - 78"}},"transferDetails":{"card":{"cardInfo":{"cardHolderName":"card_holder_name","expirationMonth":6,"expirationYear":2029,"bin":"424242","last4":"4242","brand":"VISA"},"cardId":"8736453a-dad0-4f26-85f0-95e8787d0237"}},"amountDetails":{"taxWithholdDetails":{"taxRate":{"modifierType":"RATE","type":"CO_IVA_TAX","rate":0.02},"withholdAmount":200}},"transferStatus":"SETTLED","description":"this is a test pay","callbackUrl":"https://api.client.com/callback/","subMerchantId":"UUID"}
Transfer status code, 200 transaction SETTLED or IN_PROGRESS, other FAILED
transferErrorMsg
String
Provide detailed error messages if payments fail. Please refer to the descriptions of the relevant status codes for 2xxx.
referenceId
String
Unique key to payment ticket, generated by Liquido.
idempotencyKey
String
Unique key to ensure idempotent requests. given by the merchant in their system
amount
Long
The transfer amount
country
String
country code
currency
String
The currency code of the transferred fund
finalAmount
Long
The final amount that is used for creating the charge order. EX: for charge orders with FX conversion, this field represents the converted amount from the original requested amount.
finalCurrency
String
The currency code of the finalAmount.
paymentMethod
String
payment method, enum value as CARD
payer
JSON
payer info
transferDetails
JSON
transaction details info
amountDetails
JSON
amount details info
description
String
description of payment
callbackUrl
String
URL where Liquido will send notifications associated to changes to this payment. will receive a post request.
createTime
String
Payment ticket created time
scheduledTime
String
Payment ticket scheduled time
finalStatusTime
String
Transfer final status update time, final status include SETTLED, FAILED