{"idempotencyKey":"0bd88f8a-2c7e-4b95-903f-8da45d0e6129","amount":10000,"currency":"BRL","country":"BR","paymentMethod":"BOLETO","paymentFlow":"DIRECT","payer":{"name":"Cliente - Isabela","document":{"documentId":"51234567890","type":"CPF"},"email":"testeemail@gmail.com","phone":"+55 81987654321","billingAddress":{"zipCode":"04794000","state":"SP","city":"Sao Paulo","district":"Vila Gertrudes","street":"Avenida das Nacoes Unidas","number":"14401"}},"orderInfo":{"orderId":"test-order-id","shippingInfo":{"name":"shipping test name","phone":"+55 81987654321","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"}}},"paymentTerm":{"paymentDeadline":1671194415},"description":"this is a test pay","callbackUrl":"https://api.client.com/callback/","subMerchantId":"UUID"}
Create a Boleto payment with REDIRECT payment flow¶
Request Body
{"idempotencyKey":"0bd88f8a-2c7e-4b95-903f-8da45d0e6129","amount":10000,"currency":"BRL","country":"BR","paymentMethod":"BOLETO","paymentFlow":"REDIRECT","payer":{"name":"Cliente - Isabela","document":{"documentId":"51234567890","type":"CPF"},"email":"testeemail@gmail.com","phone":"+55 81987654321","billingAddress":{"zipCode":"04794000","state":"SP","city":"Sao Paulo","district":"Vila Gertrudes","street":"Avenida das Nacoes Unidas","number":"14401"}},"orderInfo":{"orderId":"test-order-id","shippingInfo":{"name":"shipping test name","phone":"+55 81987654321","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"}}},"paymentTerm":{"paymentDeadline":1671194415},"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,"transferErrorMsg":"","idempotencyKey":"0bd88f8a-2c7e-4b95-903f-8da45d0e6129","referenceId":"0bd88f8a-2c7e-4b95-903f-8da45d0e6129","paymentMethod":"BOLETO","paymentFlow":"REDIRECT","amount":10000,"currency":"BRL","finalAmount":10000,"finalCurrency":"BRL","country":"BR","createTime":"2022-12-08 08:02:14 UTC","scheduledTime":"2022-12-08 08:02:15 UTC","payer":{"name":"Cliente - Isabela","document":{"documentId":"51234567890","type":"CPF"},"email":"testeemail@gmail.com","phone":"+55 81987654321","billingAddress":{"zipCode":"04794000","state":"SP","city":"Sao Paulo","district":"Vila Gertrudes","street":"Avenida das Nacoes Unidas","number":"14401"}},"transferStatus":"IN_PROGRESS","description":"this is a test","callbackUrl":"https://api.liquido.com/v1/cashier/callback/","transferDetails":{"boleto":{"barcode":"33299919800000100000001110725354807300286435","digitalLine":"33290001151072535480673002864350991980000010000","paymentTerm":{"paymentDeadline":1671194415}}},"subMerchantId":"UUID","redirectUrl":"https://www.redirect-qa.liquido.com?uid=ZddGZfCB6OergiZ","merchantRedirectInfo":{"merchantPageUrl":"https://www.merchantpageexample.com/123456"}}
Transfer status code, 200 transaction SETTLED or IN_PROGRESS, other FAILED
transferErrorMsg
String
Transfer error message if failed
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.
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
subMerchantId
String
The sub merchant ID.
redirectUrl
String
The URL where you must redirect your customer to complete the payment. It will be included in the response when “paymentFlow” is “REDIRECT” in the request parameters.
fullname(Input specification: Only a combination of uppercase and lowercase letters, numbers and spaces is allowed. Spanish and Portuguese letters, and other special characters are not allowed).
email
String
email.
phone
String
Mobile phone number. Should include “+55” as a prefix.
It is a URL that redirects to merchant page. It should be include when you need Liquido to redirect your customers back to your page after customers finish payments. This URL can only be set when ‘paymentFlow’ is ‘REDIRECT’ in the payment request.