Boleto

curl -X POST https://api.bspay.co/v2/transactions/boleto \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150.00,
    "method": "BOLETO",
    "external_id": "pedido_123",
    "due_date": "2026-10-20",
    "description": "Pedido #123",
    "payer": {
      "name": "João da Silva",
      "document": "11370243480",
      "email": "[email protected]",
      "phone": "11987654321",
      "address": {
        "address": "Avenida Paulista",
        "number": "1000",
        "complement": "Sala 101",
        "district": "Bela Vista",
        "city": "São Paulo",
        "zipCode": "01310100",
        "uf": "SP"
      }
    },
    "postback_url": "https://seusite.com/webhook"
  }'

$ch = curl_init('https://api.bspay.co/v2/transactions/boleto');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer {$token}",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'amount'       => 150.00,
        'method'       => 'BOLETO',
        'external_id'  => 'pedido_123',
        'due_date'     => '2026-10-20',
        'description'  => 'Pedido #123',
        'payer'        => [
            'name'     => 'João da Silva',
            'document' => '11370243480',
            'email'    => '[email protected]',
            'phone'    => '11987654321',
            'address'  => [
                'address'    => 'Avenida Paulista',
                'number'     => '1000',
                'complement' => 'Sala 101',
                'district'   => 'Bela Vista',
                'city'       => 'São Paulo',
                'zipCode'    => '01310100',
                'uf'         => 'SP',
            ],
        ],
        'postback_url' => 'https://seusite.com/webhook',
    ]),
]);
$res = json_decode(curl_exec($ch), true);
// $res['data']['payment_info']['digitable_line'] → linha digitável
// $res['data']['payment_info']['url']            → PDF do boleto

const res = await fetch('https://api.bspay.co/v2/transactions/boleto', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 150.00,
    method: 'BOLETO',
    external_id: 'pedido_123',
    due_date: '2026-10-20',
    description: 'Pedido #123',
    payer: {
      name: 'João da Silva',
      document: '11370243480',
      email: '[email protected]',
      phone: '11987654321',
      address: {
        address: 'Avenida Paulista',
        number: '1000',
        complement: 'Sala 101',
        district: 'Bela Vista',
        city: 'São Paulo',
        zipCode: '01310100',
        uf: 'SP'
      }
    },
    postback_url: 'https://seusite.com/webhook'
  })
});
const { data } = await res.json();
// data.payment_info.digitable_line → linha digitável
// data.payment_info.url            → PDF do boleto

import requests

res = requests.post(
    'https://api.bspay.co/v2/transactions/boleto',
    headers={'Authorization': f'Bearer {token}', 'Content-Type': 'application/json'},
    json={
        'amount': 150.00,
        'method': 'BOLETO',
        'external_id': 'pedido_123',
        'due_date': '2026-10-20',
        'description': 'Pedido #123',
        'payer': {
            'name': 'João da Silva',
            'document': '11370243480',
            'email': '[email protected]',
            'phone': '11987654321',
            'address': {
                'address': 'Avenida Paulista',
                'number': '1000',
                'complement': 'Sala 101',
                'district': 'Bela Vista',
                'city': 'São Paulo',
                'zipCode': '01310100',
                'uf': 'SP'
            }
        },
        'postback_url': 'https://seusite.com/webhook'
    }
)
data = res.json()['data']
# data['payment_info']['digitable_line'] → linha digitável
# data['payment_info']['url']            → PDF do boleto

{
  "success": true,
  "data": {
    "transaction_id": "bc29f8989cc0ab75a9c4a691e716bbf4",
    "external_id": "pedido_123",
    "currency": "BRL",
    "amount": 150.00,
    "fee": 1.50,
    "payment_method": "boleto",
    "payment_info": {
      "barcode": "23795000020000015000900100012345678900000012345",
      "digitable_line": "23790.00005 00000.015008 00100.012345 6 78900000012345",
      "url": "https://provider.example.com/boleto/abc123.pdf",
      "due_date": "2026-10-20",
      "registration": "registered"
    },
    "status": "pending",
    "postback_url": "https://seusite.com/webhook",
    "created_at": "2026-10-13T15:00:00-03:00"
  },
  "request_id": "7ff30940df6de2e368af7ea2",
  "timestamp": "2026-10-13T18:00:00Z"
}

{
  "success": true,
  "data": {
    "transaction_id": "a0560a3bfe9efd04ad0a19fdd743e8df",
    "external_id": "pedido_124",
    "currency": "BRL",
    "amount": 150.00,
    "fee": 1.50,
    "payment_method": "pix_boleto",
    "payment_info": {
      "barcode": "23795000020000015000900100012345678900000012345",
      "digitable_line": "23790.00005 00000.015008 00100.012345 6 78900000012345",
      "url": "https://provider.example.com/boleto/xyz456.pdf",
      "due_date": "2026-10-20",
      "registration": "registered",
      "qrcode": "00020101021226640014br.gov.bcb.pix..."
    },
    "status": "pending",
    "postback_url": "https://seusite.com/webhook",
    "created_at": "2026-10-13T15:00:00-03:00"
  },
  "request_id": "7ff30940df6de2e368af7ea3",
  "timestamp": "2026-10-13T18:00:00Z"
}

{
  "success": true,
  "data": {
    "transaction_id": "...",
    "payment_method": "boleto",
    "payment_info": {
      "barcode": null,
      "digitable_line": null,
      "url": null,
      "due_date": "2026-10-20",
      "registration": "pending_registration"
    },
    "status": "pending",
    "created_at": "2026-10-13T15:00:00-03:00"
  }
}