curl --request POST \
  --url https://api.visorfinance.app/v1/pix-payments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "amount": "20.00",
  "bank": "Nubank",
  "description": "Almoço",
  "key_type": "cpf",
  "pix_key": "123.456.789-09"
}
'

{
  "data": {
    "amount": "20.00",
    "bank": {
      "linked": true,
      "name": "Nubank"
    },
    "created_at": "2026-10-22T15:31:02Z",
    "currency": "BRL",
    "description": "Almoço",
    "end_to_end_id": null,
    "failure": null,
    "id": "7b2d5e91-3c4a-4f68-9a0b-1c2d3e4f5a6b",
    "paid_at": null,
    "pix_key_masked": "***.456.789-**",
    "recipient": null,
    "start_url": "https://dashboard.visorfinance.app/pix/payments/continue?ref=SFMyNTY.g2gDdAAAAAJ",
    "status": "pending",
    "waiting_for": "payment_confirmation"
  }
}

{
  "errors": [
    {
      "code": "BAD_REQUEST",
      "details": {
        "field": "currency_code"
      },
      "message": "The request is malformed.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}

{
  "errors": [
    {
      "code": "INVALID_TOKEN",
      "details": {},
      "message": "The personal API token is not valid.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}

{
  "errors": [
    {
      "code": "INSUFFICIENT_SCOPE",
      "details": {
        "required_scope": "pix:payments:write"
      },
      "message": "The personal API token does not grant this operation.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}

{
  "errors": [
    {
      "code": "INVALID_TOKEN",
      "details": {},
      "message": "<string>",
      "request_id": "<string>"
    }
  ]
}

{
  "errors": [
    {
      "code": "IDEMPOTENCY_CONFLICT",
      "details": {},
      "message": "This Idempotency-Key was already used with a different request.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}

{
  "errors": [
    {
      "code": "BANK_REQUIRED",
      "details": {
        "banks": [
          "Nubank",
          "Itaú"
        ]
      },
      "message": "Send the bank the Pix comes from in the bank field. See details.banks for suggestions.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}

{
  "errors": [
    {
      "code": "RATE_LIMITED",
      "details": {
        "retry_after_seconds": 42
      },
      "message": "Too many requests. Retry after the number of seconds in Retry-After.",
      "request_id": "F8x2kQ9vXc1AAAAB"
    }
  ]
}