Pix
Cómo utilizar Pix para realizar un payin en Brasil.
Pix Payin
POST
https://gateway-test.pagsmile.com/trade/pay
Este endpoint te permite usar Pix para realizar un payin en Brasil.
Headers
Name | Type | Description |
---|---|---|
Content-Type* | string | applicacion/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 | Teléfono de usuario |
customer.email* | string | Correo de usuario |
customer.identify.number* | string | Número de identificación de usuario - 11 digitos CPF o 14 digitos CNPJ - |
method* | string | Valor fijo: PIX |
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 - 0.1~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 |
address.street_number | string | Número de calle |
address.city | string | ciudad |
address.state | string | provincia |
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 Usado para controlar expiración de código QR. |
Consejos de pago a usuarios
Los usuarios solo necesitan escanear el código QR para finalizar el pago. El código QR se puede generar con qr_code value.
Agregue un botón Copy QRCODE. Para los usuarios móviles, pueden copiar el string de qr_code y pegarla en su aplicación de billetera para finalizar el pago. Agregar un botón de copia podría ayudar a mejorar la experiencia de pago del usuario.
qr_code_url y qr_code_img son imágenes de código qr generadas por el sistema que se pueden utilizar directamente en el sitio web del merchant según las necesidades.
Ejemplo
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 de prueba.
Favor utilizar tu propio app_id y genera tu propio authorization token al realizar pruebas.
Last updated