Pix Send

This page contains the endpoint responsible for managing Pix Sending

Send Pix Payment

Endpoint to process a Pix payment initiated by an indirect participant institution.

POST /v1/pix/send

Requires authorization for the scope: pix.ind.send

Request

Example

{
  "endToEndId": "E123456782025040213339f21230922d",
  "priorityType": "NORM",
  "value": "100.50",
  "requestedPaymentDate": "2025-03-19T13:54:37.000Z",
  "initiation": {
    "type": "MANU"
  },
  "extras": {
    "identifier": "ABC123XYZ",
    "description": "Pagamento Pix",
    "pixAuto": {
      "recurrenceId": "RR1234567820240115abcdefghijk",
      "recurrenceRequestId": "SC1234567820240115abcdefghijk"
    }
  },
  "origin": {
    "account": {
      "accountNumber": "00000123",
      "branch": "0001",
      "type": "CACC"
    },
    "owner": {
      "name": "Remetente da Silva",
      "document": "12345678900",
      "type": "NATURAL_PERSON"
    }
  },
  "destination": {
    "account": {
      "accountNumber": "00000456",
      "branch": "0002",
      "type": "CACC",
      "participant": "12345678"
    },
    "owner": {
      "name": "Destinatário da Silva",
      "document": "09876543211",
      "type": "NATURAL_PERSON"
    },
    "entry": {
      "key": "[email protected]"
    }
  }
}

Responses

The responses below represent Success(200) from the consumption.

🟢 200

{
"endToEndId": "E123456782025010813339f21230922d",
"value": "1.00",
"timestamp": {
  "request": "2025-03-26T18:28:59Z"
},
"status": "PROCESSING"
}

🔴 400

{
"responseTime": 13716,
"correlationId": "0068042d-fb06-4d0c-8639-ebfd774297b3",
"error": {
  "title": "Validation Error",
  "name": "json_validation_error"
}
}

🔴 401

{
"responseTime": 1142,
"correlationId": "e0cfbc00-d3be-4db6-bb84-3f1cc4f69abc",
"error": {
  "title": "Token inválido ou expirado",
  "name": "unauthorized"
}
}

🔴 403

{
"responseTime": 928,
"correlationId": "a832fe3a-1085-4ae5-a3a2-b387205b843d",
"error": {
  "title": "Acesso negado para este recurso",
  "name": "forbidden"
}
}

🔴 500

{
"responseTime": 1081,
"correlationId": "9973539d-9691-4c68-a8c1-26558033df0c",
"error": {
  "title": "Erro inesperado no processo de autorização",
  "name": "erro_autorizacao"
}
}

🔴 503

{
"responseTime": 888,
"correlationId": "5f772e52-cce4-4bd6-8577-5fbbcb0dcdf7",
"error": {
  "title": "Serviço temporariamente indisponível",
  "name": "service_unavailable"
}
}