Pagamento por Dados Bancarios

Envie um pagamento Pix informando os dados bancarios do destinatario (ISPB, agencia, conta).

O header x-idempotency-key e essencial para evitar pagamentos duplicados. Sempre envie uma chave unica no header para cada pagamento. Se uma requisicao com a mesma x-idempotency-key for enviada novamente, a API retornara o resultado do pagamento original sem criar um novo.

O campo payment e um objeto com currency (sempre "BRL") e amount em reais com decimais. Ex: 100.00 = R$ 100,00.

Valores aceitos para accountType: CACC (Conta Corrente), SVGS (Poupanca), TRAN (Conta de Pagamento), SLRY (Conta Salario).

POST/api/v2/pix/payments/manu

Realiza um pagamento Pix para o destinatario identificado pelos dados bancarios informados.

Base URL: https://pagamentos.basspago.com.br

Headers

Header	Valor	Descricao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2
`Content-Type`	application/json
`x-idempotency-key`	unique-key-123e4567-e89b-12d3-a456-426614174000	Chave unica para evitar pagamentos duplicados

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`priority`	string	Opcional	"HIGH" ou "NORM" (padrao). HIGH = processamento instantaneo, NORM = enfileirado
`paymentFlow`	string	Opcional	"APPROVAL_REQUIRED" ou "INSTANT" (padrao). Define se o pagamento requer aprovacao antes de ser processado
`expiration`	integer	Opcional	Timeout da fila em segundos (1-10800, padrao 600). Aplica-se apenas quando priority e "NORM"
`payment`	object	Obrigatorio	Objeto com currency ("BRL") e amount (valor em reais com decimais). Ex: { "currency": "BRL", "amount": 100.00 }
`payment.currency`	string	Obrigatorio	Moeda do pagamento. Sempre "BRL"
`payment.amount`	number	Obrigatorio	Valor em reais com decimais. Ex: 100.00 = R$ 100,00
`creditorAccount`	object	Obrigatorio	Objeto com os dados bancarios do destinatario
`creditorAccount.ispb`	string	Obrigatorio	Codigo ISPB da instituicao financeira do destinatario (8 digitos)
`creditorAccount.document`	string	Obrigatorio	CPF ou CNPJ do destinatario
`creditorAccount.issuer`	string	Obrigatorio	Numero da agencia do destinatario
`creditorAccount.number`	string	Obrigatorio	Numero da conta do destinatario
`creditorAccount.accountType`	string	Obrigatorio	Tipo da conta: CACC (Corrente), SVGS (Poupanca), TRAN (Pagamento), SLRY (Salario)
`creditorAccount.name`	string	Obrigatorio	Nome completo do titular da conta destinataria
`description`	string	Opcional	Descricao do pagamento

Exemplo de Request

{
  "priority": "HIGH",
  "paymentFlow": "INSTANT",
  "expiration": 600,
  "payment": {
    "currency": "BRL",
    "amount": 250.50
  },
  "creditorAccount": {
    "ispb": "00000000",
    "document": "12345678900",
    "issuer": "0001",
    "number": "1234567-8",
    "accountType": "CACC",
    "name": "Joao da Silva"
  },
  "description": "Pagamento de servico"
}

Exemplo de Response

{
  "id": "pay_abc123def456",
  "status": "PROCESSING",
  "priority": "HIGH",
  "paymentFlow": "INSTANT",
  "payment": {
    "currency": "BRL",
    "amount": 250.50
  },
  "creditorAccount": {
    "ispb": "00000000",
    "document": "12345678900",
    "issuer": "0001",
    "number": "1234567-8",
    "accountType": "CACC",
    "name": "Joao da Silva"
  },
  "description": "Pagamento de servico",
  "idempotencyKey": "unique-key-123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-04-08T10: 30:00Z"
}

Exemplos de Codigo

curl -X POST \
  https://pagamentos.basspago.com.br/api/v2/pix/payments/manu \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -H 'x-idempotency-key: unique-key-123e4567-e89b-12d3-a456-426614174000' \
  -d '{
    "priority": "HIGH",
    "paymentFlow": "INSTANT",
    "expiration": 600,
    "payment": {
      "currency": "BRL",
      "amount": 250.50
    },
    "creditorAccount": {
      "ispb": "00000000",
      "document": "12345678900",
      "issuer": "0001",
      "number": "1234567-8",
      "accountType": "CACC",
      "name": "Joao da Silva"
    },
    "description": "Pagamento de servico"
  }'