Este objeto é responsável por apresentar todos os dados disponíveis em uma transferência.
Atributos
amount Object
Objeto que contém as informações do valor a ser transacionado.
value String
Valor a ser cobrado em centavos. Apenas números inteiros positivos.
Exemplo: R$ 1.500,99 = 150099
currency String (3 caracteres)
Código de moeda ISO de três letras, em maiúsculas. Por enquanto, apenas o Real brasileiro é suportado
(“BRL”).
Exemplo: BRL
description String
Descrição da transferência. Caso o campo seja enviado, deve conter no mínimo 1 e, no máximo, 72 caracteres
alfanuméricos.
Exemplo: Valor referente as vendas do dia 01/01
reference_id String
Identificador próprio atribuído para a transferência. Tamanho máximo permitido: 64 caracteres alfanuméricos.
Exemplo: referencia_cliente12345
instrument Object
Objeto contendo as informações da transferência.
type ENUM
Tipo da transação. A utilização de transferência utilizando
PIX precisa da liberação do time comercial do PagBank. Caso liberado, obrigatoriamente, deve enviar o objeto
"pix". Ao selecionar o tipo de transferência PIX, a
transferência pode ser feita utilizando os dados do PIX do recebedor ou os dados da conta bancária.
Caso você selecione "P2P", obrigatoriamente, deve enviar o objeto "p2p".
Valores de ENUM:
P2P
(transferência entre contas Pags).PIX
(transferência para outros domicílios bancários).
p2p Object
Objeto que contém as informações da conta destino para uma transferência entre contas PagBank.
Caso o type seja "P2P", este é um objeto obrigatório.
branch String
Agência bancária do recebedor (Máximo 10 caracteres). Para uma transferência P2P, você deve
obrigatoriamente enviar os campos bank_branch
e account_number
ou o
account_id
.
Exemplo: 1234
account_number String
Número da conta do recebedor (Máximo 20 caracteres). Para uma transferência P2P, você deve
obrigatoriamente enviar os campos bank_branch
e account_number
ou o
account_id
.
O número da conta deve conter o digito verificador sem o hífen.
Exemplo: 1234567
account_id String
Identificador da conta destino PagBank. Para uma transferência P2P, o campo
email
ou account_id
deve, obrigatoriamente, ser enviado.
Exemplo: [email protected]
pix Object
Objeto que contém informações sobre transferência para outros domicílios bancários.
Os campos key
e tax_id
são obrigatórios caso a transferência utilize o sistema
PIX. Já se a transferência for convencional, os campos bank_ispb
, bank_branch
,
account_number
e account_type
são obrigatórios.
key
e tax_id
são obrigatórios caso a transferência utilize o sistema
PIX. Já se a transferência for convencional, os campos bank_ispb
, bank_branch
,
account_number
e account_type
são obrigatórios.
key String
Chave que identifica a conta destino para uma transferência via PIX.
Campo obrigatório para uma transferência PIX.
Exemplo: chavePIXdaConta
name String (140 caracteres)
Nome completo do recebedor.
Exemplo: João da Silva
tax_id String (11/14 caracteres)
Número do documento (CPF ou CPNJ) do portador do cartão de crédito, cartão de débito e token de rede.
Exemplo: 12345678910
bank_ispb String (8 caracteres)
ISPB do banco do recebedor. Devem ser enviados apenas números.
Exemplo: 12345678
bank_branch String (8 caracteres)
Agência bancária do recebedor.
Exemplo: 1234
account_number String (20 caracteres)
Número da conta do recebedor.
Exemplo: 1234567
account_type ENUM
Tipo de conta do recebedor.
Valores de ENUM:
CC
PP
PG
CS
notification_urls String
Contém as URLs que receberão as notificações do pedido (por ora, somente aceitamos uma url apenas. Aceitaremos
mais URLs em breve.)
Exemplo: https://webhook.site/067fc99b-88e7-4e30-8f74-609901413fe7