Transferir por Chave Pix

Envie uma transferencia Pix utilizando a chave Pix do destinatario.

A idempotencyKey e essencial para evitar transferencias duplicadas. Sempre utilize uma chave unica para cada transferencia. Se uma requisicao com a mesma idempotencyKey for enviada novamente, a API retornara o resultado da transferencia original sem criar uma nova.

Valores aceitos para pixKeyType: CPF, CNPJ, EMAIL, PHONE, EVP (chave aleatoria).

POST/api/v2/pix/payments/dict

Realiza uma transferencia Pix para o destinatario identificado pela chave Pix informada.

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

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`amount`	integer	Obrigatorio	Valor em centavos. Ex: 1000 = R$ 10,00
`description`	string	Opcional	Descricao da transferencia
`pixKey`	string	Obrigatorio	Chave Pix do destinatario
`pixKeyType`	string	Obrigatorio	Tipo da chave Pix: CPF, CNPJ, EMAIL, PHONE, EVP
`idempotencyKey`	string	Obrigatorio	Chave unica para evitar transferencias duplicadas

Exemplo de Request

{
  "amount": 1000,
  "description": "Payment for services",
  "pixKey": "12345678900",
  "pixKeyType": "CPF",
  "idempotencyKey": "unique-key-123e4567-e89b-12d3-a456-426614174000"
}

Exemplo de Response

{
  "id": "pay_abc123def456",
  "status": "PROCESSING",
  "amount": 1000,
  "description": "Payment for services",
  "pixKey": "12345678900",
  "pixKeyType": "CPF",
  "idempotencyKey": "unique-key-123e4567-e89b-12d3-a456-426614174000",
  "createdAt": "2026-04-03T10:30:00Z"
}

Exemplos de Codigo

curl -X POST \
  https://pagamentos.basspago.com.br/api/v2/pix/payments/dict \
  -H 'Authorization: Bearer {access_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 1000,
    "description": "Payment for services",
    "pixKey": "12345678900",
    "pixKeyType": "CPF",
    "idempotencyKey": "unique-key-123e4567-e89b-12d3-a456-426614174000"
  }'