Boleto

Cómo utilizar Boleto para realizar un payin en Brasil.

Payin por Boleto

POST https://gateway-test.pagsmile.com/trade/pay

Este endpoint te permite usar Boleto para realizar un payin en Brasil.

Headers

Name
Type
Description

Content-Type*

string

application/json; chartset=UTF-8

Authorization*

string

Basic Base($app_id:$security_key)

Request Body

Name
Type
Description

app_id*

string

Id de app creado en dashboard

- Max. 32 chars -

customer.phone*

string

User's phone

customer.email*

string

Teléfono de usuario

customer.identify.number*

string

Número de identificación de usuario- 11 digitos CPF o 14 digitos CNPJ -

method*

string

Valor fijo: Boleto

out_trade_no*

string

ID dado por el merchant en su sistema

- Max. 64 chars -

notify_url*

string

Donde Pagsmile enviará la notificación

customer.identify.type*

string

Tipo de identificación de usuario- CPF o CNPJ -

customer.name*

string

Nombre de usuario

timestamp*

string

yyyy-MM-dd HH:mm:ss - Max. 19 chars -

subject*

string

Razón de pago o título

- Max. 128 chars -

order_amount*

string

Monto de pago - 4~50,000 BRL -

order_currency*

string

Valor fijo: BRL

content*

string

Detalle de razón de pago o título. Se mostrará en el recibo del banco.- Max. 255 chars -

buyer_id*

string

Usuario id de merchant

address.zip_code*

string

zip code

website_url

string

URL de website de merchant- Max. 128 chars -

address.street

string

calle

- Requerido si no hay zip_code -

address.street_number

string

Número de calle

- Requerido si no hay zip_code -

address.city

string

ciudad

- Requerido si no hay zip_code -

address.state

string

provincia - Requerido si no hay zip_code -

return_url

string

web URL de redirección al finalizar checkout

cancellation_express

string

m(minutos), h(horas), d(días). Valor debe ser integer.

Ex: 90m El valor debe ser mayor que el timeout express. Usado para controlar expiración del Boleto voucher.

timeout_express

strng

Usado para controlar tiempo de expiración de enviar una orden (desde initial a processing). (90m defecto, max 15d)

Consejos de pago para el usuario

  • El valor de bank_code es el número de billete que el usuario necesita utilizar para el pago

  • Usar el valor del barcode para generar un código de barras escaneable puede ayudar a los usuarios a realizar el pago más rápido

  • Proporcionar una versión PDF descargable podría ayudar a los usuarios móviles a tener sus tickets en sus teléfonos sin mantener el navegador abierto

Ejemplo

Example of payment page
Example of Boleto PDF

Nota: 162************38 es el test ID de pagsmile para prueba en sandbox, y MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ== es el token de autorización asociado con el app ID

Last updated