Pix
Como usar o Pix para criar um Payin no Brasil.
Payin por Pix
POST
https://gateway-test.pagsmile.com/trade/pay
Este endpoint permite submeter um pagamento por Pix no 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 | App Id criado no dashboard - Max. 32 chars - |
customer.phone* | string | Telefone do usuário |
customer.email* | string | E-mail do usuário |
customer.identify.number* | string | Número de identificação do usuário - 11 dígitos se CPF ou 14 dígitos se CNPJ - |
method* | string | Valor fixo: PIX |
out_trade_no* | string | ID fornecido pelo merchant em seu sistema - Max. 64 chars - |
notify_url* | string | Para onde a Pagsmile enviará a notificação |
customer.identify.type* | string | Tipo de identificação do usuário - CPF ou CNPJ - |
customer.name* | string | Nome do usuário |
timestamp* | string | yyyy-MM-dd HH:mm:ss - Max. 19 chars - |
subject* | string | motivo do pagamento ou título do item - Max. 128 chars - |
order_amount* | string | montante do pagamento - 0.1~50,000 BRL - |
order_currency* | string | Valor fixo: BRL |
content* | string | detalhes do motivo do pagamento ou detalhes do item. Isso será mostrado na fatura do banco. - Max. 255 chars - |
buyer_id* | string | ID do usuário do merchant |
address.zip_code | string | código postal |
website_url | string | URL do site do comerciante - Max. 128 chars - |
address.street | string | rua |
address.street_number | string | número da rua |
address.city | string | cidade |
address.state | string | estado |
return_url | string | Redireccionar para a url do Merchant quando o usuário terminar o checkout |
cancellation_express | string | m(minutos), h(horas), d(dias). O valor deve ser um número inteiro. Ex: 90m Utilizado para controlar a expiração de QR code |
Dicas para pagamento
Os usuários só precisam ler o QRCode para finalizar o pagamento. O QRCode pode ser gerado com o valor qr_code.
Adicione um botão de cópia do QRCODE. Para usuários móveis, eles podem copiar a string do código qr_code e colá-lo em seu aplicativo para finalizar o pagamento. Adicionar um botão de cópia pode ajudar a melhorar a experiência de pagamento do usuário.
qr_code_url e qr_code_img são imagens geradas pelo sistema de QRCode que podem ser usadas diretamente no site do comerciante, dependendo das necessidades.
Exemplo
Importante: 162************38 é o App Id de teste da pagsmile para o ambiente sandbox, e MTYyNTgyOTIxNDUzMTY2Mzg6UGFnc21pbGVfc2tfZDUwMWQ1ZGNkNTI5OGQ5N2MwNmUzYjI4YjA2OWZjZmY3NDU5ZjY2NzNiMjFjMTFlYTY3NDM5MDgzOTZkOTYxNQ== é o token de autorização associado ao App Id de teste.
Use seu próprio app_id e gere seu próprio token de autorização ao testar.
Last updated