Documentação: API Pagamentos

Introdução

Este script permite a geração de um QR Code PIX utilizando um endpoint específico. É ideal para aplicações que precisam de integração com pagamentos via PIX.

Exemplo de Código

          <?php
          $apiUrl = 'https://duspay.com.br/v3/pix/qrcode';
          $postData = [
          'client_id' => 'seu_client_id',
          'client_secret' => 'seu_client_secret',
          'nome' => 'Nome do Cliente',
          'cpf' => 'CPF do Cliente',
          'valor' => 100.00,
          'descricao' => 'Descrição do pagamento',
          'urlnoty' => 'https://seuservidor.com/callback'
          ];
          $ch = curl_init();
          curl_setopt($ch, CURLOPT_URL, $apiUrl);
          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
          curl_setopt($ch, CURLOPT_POST, true);
          curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
          curl_setopt($ch, CURLOPT_HTTPHEADER, [
          'Content-Type: application/x-www-form-urlencoded',
          ]);
          $response = curl_exec($ch);
          if (curl_errno($ch)) {
          echo 'Erro cURL: ' . curl_error($ch);
          } else {
          echo 'Resposta do servidor: ' . $response; 
          }
          curl_close($ch);
          ?>
        

Parâmetros

Parâmetro	Descrição	Exemplo
client_id	Identificação do cliente	"seu_client_id"
client_secret	Chave secreta do cliente	"seu_client_secret"
nome	Nome do pagador	"João da Silva"
cpf	CPF do pagador	"12345678901"
valor	Valor da transação	100.00
descricao	Descrição da transação	"Pagamento de serviços"
urlnoty	URL para receber notificações de callback	"https://seuservidor.com/callback"

Respostas da API

Exemplo de Resposta 200:

            {
            "status": 200,
            "body": {
              "statusCode": 200,
              "message": "QR Code gerado com sucesso.",
              "qrcode": "00020126870014br.gov.bcb.pix2565pix.primepag.com.br/qr/v3/at/cbe9aea5-ea38-4675-9b1d-1bb9085cea725204000053039865802BR5925NEXUS TECH INTERMEDIACOES6008CRICIUMA62070503***63040DA2",
              "reference_code": "391a74417845ac91c1773b9cdc91c1"
            }
            }
          

Exemplo de Resposta 401:

            {
 
            "statusCode": 401,
 
            "message": "Erro de autorização"
 
            }

Introdução

Este script permite a realização de uma transferência PIX entre contas utilizando um endpoint específico. Ideal para sistemas que necessitam de integração com a API PIX para realizar pagamentos e transferências.

Exemplo de Código

          <?php
          $apiUrl = 'https://duspay.com.br/v3/pix/payment';
          $postData = [
            'client_id' => 'SEU CLIENT ID',
            'client_secret' => 'SEU CLIENT SECRET',
            'nome' => 'Nome do cliente',
            'cpf' => 'Cpf do cliente',
            'valor' => 1.00,
            'chave_pix' => 'Chave pix Cliente',
            'urlnoty' => 'https://seuservidor.com/callback'
          ];
          $ch = curl_init();
          curl_setopt($ch, CURLOPT_URL, $apiUrl);
          curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
          curl_setopt($ch, CURLOPT_POST, true);
          curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($postData));
          curl_setopt($ch, CURLOPT_HTTPHEADER, [
            'Content-Type: application/x-www-form-urlencoded',
          ]);
          $response = curl_exec($ch);
          if (curl_errno($ch)) {
            echo 'Erro cURL: ' . curl_error($ch);
          } else {
            echo 'Resposta do servidor: ' . $response;
          }
          curl_close($ch);
          ?>
        

Parâmetros

Parâmetro	Descrição	Exemplo
client_id	Identificação do cliente	"seu_client_id"
client_secret	Chave secreta do cliente	"seu_client_secret"
nome	Nome do pagador.	"cris"
cpf	CPF do pagador.	"11970142332"
valor	Valor da transferência.	1.00
chave_pix	Chave PIX do destinatário.	"chave@pix.com"
urlnoty	URL para receber notificações de callback.	"https://seuservidor.com/callback"

Respostas da API

Exemplo de Resposta 200:

[{"statusCode":200,"message":"Saque PIX processado com sucesso"}]

Exemplo de Resposta 400:

{"statusCode":400,"message":"Saldo insuficiente para cobrir valor e taxas."}

WEBHOOK-Evento de Pagamento

Será lhe enviado um alerta por meio de um Webhook assim que o pagamento for confirmado pelo nosso sistema, segue abaixo o modelo JSON do payload enviado:

{
    "requestBody": {
        "transactionType": "RECEIVEPIX",
        "transactionId": "c327ce8bee2a18565ec2m1zdu6px2keu",
        "external_id": "55aefd02e54e785fbb5a80faa19f8802",
        "amount": 15.00,
        "paymentType": "PIX",
        "status": "PAID",
        "dateApproval": "2024-10-07 16:07:10",
        "creditParty": {
            "name": "Henrique silva",
            "email": "duspay@gmail.com",
            "taxId": "999999999"
        },
        "debitParty": {
            "bank": "DusPay SOLUCOES DE PAGAMENTOS LTDA",
            "taxId": "46872831000154"
        }
    }
}

WEBHOOK-Evento de Transferência

Será lhe enviado um alerta por meio de um Webhook assim que o pagamento for confirmado pelo nosso sistema, segue abaixo o modelo JSON do payload enviado:

{
    "transactionType": "PAYMENT",
    "transactionId": "798176179",
    "external_id": "ebceb2b835598ccad73ce42eb5etrh2m5",
    "amount": 1,
    "dateApproval": "2024-12-19 17:10:54",
    "statusCode": {
        "statusId": 1,
        "description": "Pagamento aprovado"
    }
}