Documentação da API - BR Master Pay
Gerar Pagamento via PIX
Use este endpoint para gerar um QR Code dinâmico para pagamento.
Endpoint:
POST https://api.brmasterpay.com.br/v2/pix/qrcode
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Exemplo |
|---|---|---|---|
| client_id | string | Sim | exemplo_123 |
| client_secret | string | Sim | segredo123 |
| nome | string | Sim | João Silva |
| cpf | string | Sim | 12345678900 |
| valor | float | Sim | 10.00 |
| descricao | string | Sim | Recarga |
| urlnoty | string | Não | https://seudominio.com/webhook |
Exemplo de resposta:
{
"statusCode": 200,
"pixCode": "000201...",
"qrcode": "data:image/png;base64,...",
"transaction_id": "e1abc...xyz",
"external_reference": "65f4c...",
"amount": "10,00",
"expires_in": 1800
}
Transferência PIX
Endpoint para transferências de saldo via PIX.
Endpoint:
POST https://api.brmasterpay.com.br/v2/pix/payment
Parâmetros:
| Parâmetro | Tipo | Obrigatório | Exemplo |
|---|---|---|---|
| client_id | string | Sim | seu_id |
| client_secret | string | Sim | seu_segredo |
| nome | string | Sim | Carlos Lima |
| cpf | string | Sim | 98765432100 |
| valor | float | Sim | 5.00 |
| chave_pix | string | Sim | exemplo@pix.com |
| urlnoty | string | Opcional | https://seudominio.com/callback |
Resposta 200:
{
"statusCode": 200,
"message": "Transferência enviada com sucesso"
}
Webhook - Pagamento Recebido
Chamado automaticamente quando um pagamento é confirmado.
{
"requestBody": {
"transactionType": "RECEIVEPIX",
"transactionId": "abc123",
"external_id": "ext_xyz",
"amount": 15.00,
"paymentType": "PIX",
"status": "PAID",
"dateApproval": "2025-06-11 12:00:00",
"creditParty": {
"name": "João",
"email": "joao@email.com",
"taxId": "12345678900"
},
"debitParty": {
"bank": "BR MASTER PAY",
"taxId": "11222333445566"
}
}
}
Webhook - Transferência Concluída
{
"transactionType": "PAYMENT",
"transactionId": "tx9988",
"external_id": "ext_tx9a",
"amount": 8.50,
"dateApproval": "2025-06-11 12:02:30",
"statusCode": {
"statusId": 1,
"description": "Pagamento aprovado"
}
}