Integração PIX e Cartão com PagSeguro PagBank API Orders
matteus.dev é um desenvolvedor PagBank que oferece uma solução exclusiva para Integração PIX e Cartão com PagSeguro na nova API Orders (Exclusivo).
Modos de integração
A integração com gateways de pagamento permite controle intersistemas sobre as vendas realizadas. A integração com PagSeguro, especificamente, pode ser feita em três modelos de checkout: Redirecionamento, Lightbox ou Transparente.
O modelo de Checkout por Redirecionamento é o mais clássico e rápido para integração. O porém desse modelo é que ele permite pouca customização do processo de checkout e faz com que seu usuário precise acessar páginas de fora de sua loja para finalizar o checkout. É possível gerar um botão de pagamento pelo PagSeguro ou simplesmente compartilhar o link gerado onde quiser para realizar a venda.
O Checkout Lightbox já é um tipo mais discreto de checkout e também de rápida integração. Uma caixa do PagSeguro é aberta sobrepondo a página em sua própria loja virtual, evitando o redirecionamento para outras URLs do PagSeguro.
O modelo de Checkout Transparente do PagSeguro é o mais elegante e também o mais completo, para quem tem tempo para a configuração e busca uma experiência 100% personalizada em seu processo de Checkout. Isso quer dizer que é possível modificar todo o look & feel de seu Checkout sem nem precisar mostrar a logomarca do PagSeguro.
Como funciona
Fazemos a programação de um script que funciona acoplado à sua aplicação de gestão das vendas e pagamentos, realizamos o processo de garantia de qualidade (QA) e elaboramos relatórios de testes em ambiente sandbox (ambiente de teste). Realizamos homologação junto ao PagBank para tornar sua aplicação apta a realizar vendas reais.
Notificações de status
Isso requer a programação de um script que possa atualizar o status no sistema da loja virtual. Esse script fica em sua loja virtual e ficará sempre disponível para receber avisos do sistema do PagSeguro. Sua loja virtual deve ainda manter os responsáveis pelo despacho dos produtos informados sobre o status. Assim, eles podem prosseguir para o envio do produto ou iniciar outros processos de acordo com o retorno vindo do PagSeguro.
Status
Independente da forma de checkout escolhida, é preciso ter um mecanismo para sincronizar as vendas com a loja virtual. Esse mecanismo é chamado de URL de retorno. Por exemplo… Sua loja virtual precisa ser avisada instantaneamente quando o status de um pedido é modificado para:
- Completo: Significa que o pagamento já foi concluído e creditado.
- Aprovado: O pagamento já foi processado e aprovado.
- Em Análise: O pagamento foi iniciado mas está sendo analisado pelo PagSeguro.
- Devolvido: O pagamento foi devolvido.
- Cancelado: A transação foi cancelada.
Modo de pagamento recorrente (assinatura)
O PagSeguro dispõe também da API para automatização das assinaturas em seu software. A documentação está disponível em diversos formatos, mas a principal e mais atualizada delas é a Referência.
O problema
A biblioteca oficial opensource não suporta pagamentos com PIX e Cartão de Crédito com a nova API Orders. As APIs anteriores estão sendo gradualmente descontinuadas, e o projeto opensource não apresenta sinais de que irá suportar a nova API Orders.
Temos a Solução para Integrar o PagBank
Oferecemos uma melhoria para a tradicional biblioteca PHP para o PagSeguro. Trata-se da adição das opções PIX e Crédito via API Orders, utilizando as mesmas funções da biblioteca, para sua comodidade. O pagamento é transparente e a experiência de compra é totalmente personalizada para seu sistema ou loja virtual.
Ao contratar um desenvolvedor PagBank, você garante que sua integração seja homologada e que a experiência do usuário será 100% personalizada.
A requisição e resposta são diferentes do convencional utilizado para boleto e cartão.
Integração de PIX da PagBank API Orders
{
"id": "379d62ef-031f-45f2-9361-79cac7617424",
"request": {
"method": "POST",
"headers": {
"authorization": "Bearer BFE19F6EEAEF4455BFD2E35A866AF27C",
"content-type": "application/json; charset= UTF-8"
},
"params": {
"email": [
"(EMAIL)"
],
"token": [
"(TOKEN SECRETO)"
]
},
"body": {
"customer": {
"name": "CADASTRO TESTE",
"email": "[email protected]",
"tax_id": "11895008689",
"phones": [
{
"country": "55",
"area": "11",
"number": "123456789",
"type": "MOBILE"
}
]
},
"reference_id": "C-1-384",
"currency": "BRL",
"items": [
{
"reference_id": "C-1-384",
"name": "Aquisição de Curso :: TESTE 101",
"quantity": 1,
"unit_amount": "30000"
}
],
"qr_codes": [
{
"amount": {
"value": "3030000"
},
"expiration_date": "2024-08-08T21:39:51-03:00",
"duration": "2024-08-08T21:39:51-03:00"
}
],
"notification_urls": [
"https://teste.com.br/escola/lodger/assinc/transactionlisten.php"
]
}
},
"response": {
"headers": {
"content-length": "1579",
"Date": "Thu, 08 Aug 2024 00:39:53 GMT",
"Content-Type": "application/json"
},
"body": {
"id": "ORDE_7826AD3E-252A-48FB-B3C7-3CE5082E3D36",
"reference_id": "C-1-384",
"created_at": "2024-08-07T21:39:52.435-03:00",
"customer": {
"name": "CADASTRO TESTE",
"email": "[email protected]",
"tax_id": "11895008689",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "123456789"
}
]
},
"items": [
{
"reference_id": "C-1-384",
"name": "Aquisição de Curso :: TESTE 101",
"quantity": 1,
"unit_amount": 30000
}
],
"qr_codes": [
{
"id": "QRCO_D2303260-E6FC-4500-8454-8E986E12C755",
"expiration_date": "2024-08-08T21:39:51.000-03:00",
"amount": {
"value": 3030000
},
"text": "00020101021226850014br.gov.bcb.pix2563api-h.pagseguro.com/pix/v2/D2303260-E6FC-4500-8454-8E986E12C75527600016BR.COM.PAGSEGURO0136D2303260-E6FC-4500-8454-8E986E12C755520489995303986540830300.005802BR5922MATTEUS BARBOSA DOS SA6008CONTAGEM62070503***6304D9E9",
"arrangements": [
"PIX"
],
"links": [
{
"rel": "QRCODE.PNG",
"href": "https://sandbox.api.pagseguro.com/qrcode/QRCO_D2303260-E6FC-4500-8454-8E986E12C755/png",
"media": "image/png",
"type": "GET"
},
{
"rel": "QRCODE.BASE64",
"href": "https://sandbox.api.pagseguro.com/qrcode/QRCO_D2303260-E6FC-4500-8454-8E986E12C755/base64",
"media": "text/plain",
"type": "GET"
}
]
}
],
"notification_urls": [
"https://teste.com.br/escola/lodger/assinc/transactionlisten.php"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_7826AD3E-252A-48FB-B3C7-3CE5082E3D36",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_7826AD3E-252A-48FB-B3C7-3CE5082E3D36/pay",
"media": "application/json",
"type": "POST"
}
]
},
"status-code": 201
},
"created": "2024-08-07T21:39:53.251-03:00"
}
Integração de Cartão de Crédito da PagBank API Orders
{
"id": "0451ea62-59de-4167-a8dd-0c4eec1162ff",
"request": {
"method": "POST",
"headers": {
"authorization": "Bearer BFE19F6EEAEF4455BFD2E35A866AF27C",
"content-type": "application/json; charset= UTF-8"
},
"params": {
"email": [
"(EMAIL)"
],
"token": [
"(TOKEN SECRETO)"
]
},
"body": {
"customer": {
"name": "CADASTRO ESCOLA TESTE",
"email": "[email protected]",
"tax_id": "11895008689",
"phones": [
{
"country": "55",
"area": "11",
"number": "123456789",
"type": "MOBILE"
}
]
},
"reference_id": "C-1-383",
"currency": "BRL",
"items": [
{
"reference_id": "C-1-383",
"name": "Aquisição de Curso :: CURSO TESTE 101",
"quantity": 1,
"unit_amount": "30000"
}
],
"charges": [
{
"reference_id": 1,
"amount": {
"value": 300,
"currency": "BRL"
},
"payment_method": {
"soft_descriptor": "Pagto Curso",
"type": "CREDIT_CARD",
"capture": true,
"installments": 1,
"card": {
"encrypted": "m9J+1A+QsNF5CyEf/an35qtr1cFpCX/6GS6Y4enL4Wuzt3cB/E7Y2VwBKzmRWaNjXyerDbUhZyqrp2f5ZDFuoORJwa7Y1GW70adwuPkDuGkhQAdZWvT2IDNQbBBjX71TVHQEuneTVmCehKp9R4t+/DIx4xtvu1DkRIzmvn0uiNzMHPJYQfrp7+JzrrnDrzf/Oc5RaKb+wYay1+xsUKMjXuT/8lG8JgedXGBWSvY5E7fpE2wkhfNb6YH+y0IUTiGYl2+dSGNnFYFVMhVa1afKncpiXRDbGQ7g/DvHTtiiTLWp2YwX+H6c7v3qsAUGzX2KxfOf4l3MZhQhtMmOWyIV8A==",
"store": false
}
},
"description": "Test"
}
],
"notification_urls": [
"https://teste.com.br/escola/lodger/assinc/transactionlisten.php"
]
}
},
"response": {
"headers": {
"content-length": "1911",
"Date": "Thu, 08 Aug 2024 00:36:21 GMT",
"Content-Type": "application/json"
},
"body": {
"id": "ORDE_C1C6502C-6138-419D-A4BF-0F0317F54F32",
"reference_id": "C-1-383",
"created_at": "2024-08-07T21:36:17.214-03:00",
"customer": {
"name": "CADASTRO ESCOLA TESTE",
"email": "[email protected]",
"tax_id": "11895008689",
"phones": [
{
"type": "MOBILE",
"country": "55",
"area": "11",
"number": "123456789"
}
]
},
"items": [
{
"reference_id": "C-1-383",
"name": "Aquisição de Curso :: CANNABIS 101",
"quantity": 1,
"unit_amount": 30000
}
],
"charges": [
{
"id": "CHAR_44AF19AD-BC9F-4E16-9113-C00B2014EE4D",
"reference_id": "1",
"status": "PAID",
"created_at": "2024-08-07T21:36:18.031-03:00",
"paid_at": "2024-08-07T21:36:20.000-03:00",
"description": "Test",
"amount": {
"value": 300,
"currency": "BRL",
"summary": {
"total": 300,
"paid": 300,
"refunded": 0
}
},
"payment_response": {
"code": "20000",
"message": "SUCESSO",
"reference": "032416400102",
"raw_data": {
"authorization_code": "145803",
"nsu": "032416400102",
"reason_code": "00"
}
},
"payment_method": {
"type": "CREDIT_CARD",
"installments": 1,
"capture": true,
"card": {
"brand": "elo",
"first_digits": "451416",
"last_digits": "3757",
"exp_month": "12",
"exp_year": "2026",
"holder": {
"name": "TEST TESTERRR"
},
"store": false
},
"soft_descriptor": "PagtoCurso"
},
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_44AF19AD-BC9F-4E16-9113-C00B2014EE4D",
"media": "application/json",
"type": "GET"
},
{
"rel": "CHARGE.CANCEL",
"href": "https://sandbox.api.pagseguro.com/charges/CHAR_44AF19AD-BC9F-4E16-9113-C00B2014EE4D/cancel",
"media": "application/json",
"type": "POST"
}
]
}
],
"notification_urls": [
"https://teste.com.br/escola/lodger/assinc/transactionlisten.php"
],
"links": [
{
"rel": "SELF",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_C1C6502C-6138-419D-A4BF-0F0317F54F32",
"media": "application/json",
"type": "GET"
},
{
"rel": "PAY",
"href": "https://sandbox.api.pagseguro.com/orders/ORDE_C1C6502C-6138-419D-A4BF-0F0317F54F32/pay",
"media": "application/json",
"type": "POST"
}
]
},
"status-code": 201
},
"created": "2024-08-07T21:36:21.413-03:00"
}
Entregamos sua cobrança via PIX e Crédito automatizada com PagSeguro via API Orders funcional e testada. Fazemos a configuração completa.
Criação de plugins PagBank
Desenvolvemos integrações do PagBank com qualquer plataforma do mercado. Vamos tornar realidade sua automação de vendas com PagBank e a plataforma de sua preferência.
Antes
Próxima
Homologação
Para sua comodidade, realizamos o processo completo, até a homologação.
WhatsApp
