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

Example of payment page

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.

Last updated