Esse objeto representa o fechamento do carrinho de compras. Contém informações que identifica o que está sendo adquirido, o comprador, endereço de entrega e demais informações relevantes.
Atributos
id String (41 caracteres)
Identificador do pedido PagBank.
Exemplo: ORDE_F87334AC-BB8B-42E2-AA85-8579F70AA328
reference_id String (1-64 caracteres)
Identificador único atribuído para o pedido.
Exemplo: ex-00001
customer Object
Contém informações do cliente que fará pagamentos usando o serviço PagBank.
nome String (1-30 caracteres)
Nome do cliente.
Exemplo: João Souza
email String (10-255 caracteres)
E-mail do cliente.
Exemplo: [email protected]
tax_id String (11/14 caracteres)
Documento de identificação pessoal (CPF/CNPJ) do cliente. Obrigatório.
Exemplo: 12345678910
phone Array of Object
Contém uma lista de telefones do cliente.
country Int (2 caracteres)
Código de operadora do País (DDI).
Exemplo: 55
area Int (2 caracteres)
Código de operadora local (DDD).
Exemplo: 21
number Int (8-9 caracteres)
Número do telefone.
Exemplo: 123456789
type String (ENUM)
Indica o tipo de telefone.
Valores de ENUM:
MOBILE
se for um telefone celular.BUSINESS
se for um telefone comercial.HOME
se for um telefone residencial.
items Array of Object
Contém as informações dos itens inseridos no pedido.
name String (1-64 caracteres)
Nome dado ao item.
Exemplo: Nome do item
quantity Int (5 caracteres)
Quantidade referente ao item.
Exemplo: 2
unit_amount Int (9 caracteres)
Valor do item.
Exemplo: 500
reference_id String (1-255 caracteres)
Identificador único atribuído para o item.
Exemplo: Camiseta#456772332
shipping Array of Object
Contém as informações de entrega do pedido.
address Object
Contém informações do endereço de entrega do pedido.
street String (1-160 caracteres)
Rua do endereço.
Exemplo: Avenida Brigadeiro Faria Lima
number String (1-20 caracteres)
Número do endereço.
Exemplo: 1384
complement String (1-40 caracteres)
Complemento do endereço.
Exemplo: Casa
locality String (1-60 caracteres)
Bairro do endereço.
Exemplo: Pinheiros
city String (1-90 caracteres)
Cidade do endereço.
Exemplo: São Paulo
region String (1-50 caracteres)
Nome do Estado.
Exemplo: São Paulo
region_code String (2 caracteres)
Código do Estado (Padrão ISO 3166-2).
Exemplo: SP
country String (1-50 caracteres)
País do endereço (Padrão ISO 3166-1
alpha-3).
Exemplo: BRA
postal_code String (8 caracteres)
CEP do endereço.
Exemplo: 01452002
qr_codes Array of Object
Objeto contendo os QR Codes vinculados à um pedido. Ao informar o amount
, o QR code será gerado
automaticamente e pode ser pago com aplicativos de outras instituições (Pix).
Para que o QR Code aceite o pagamento Pix, o vendedor precisa ter pelo menos uma chave de endereçamento ativa
vinculada a sua conta PagBank. Caso o vendedor tenha mais de uma chave de
endereçamento cadastrada no PagBank, priorizaremos a utilização da chave de endereçamento aleatória.
amount
, o QR code será gerado
automaticamente e pode ser pago com aplicativos de outras instituições (Pix).
Para que o QR Code aceite o pagamento Pix, o vendedor precisa ter pelo menos uma chave de endereçamento ativa
vinculada a sua conta PagBank. Caso o vendedor tenha mais de uma chave de
endereçamento cadastrada no PagBank, priorizaremos a utilização da chave de endereçamento aleatória.expiration_date Datetime
Data de expiração do QR Code. Por padrão, o QR Code gerado tem validade até as 23h59m do dia seguinte caso
o parâmetro qr_codes.expiration_date
não seja definido na requisição.
Exemplo: 2021-08-29T20:15:59-03:00
amount Object
Contém informações do valor a ser utilizado no QR Code.
value Int (5 caracteres)
Valor do QR Code.
Exemplo: 500
splits Object
Contém informações da divisão de pagamento.
method ENUM
Define se os valores da divisão serão informados em valores brutos (FIXED) ou em porcentagens
(PERCENTAGE) do valor total da transação.
Valores de ENUM:
FIXED
PERCENTAGE
receivers Array de objetos
Contém a lista de recebedores participantes da divisão de pagamento. O número de objetos será igual ao
número de participantes.
amount objeto
Contém informações dos valores dos recebedores participantes da divisão.
value Int (9 caracteres)
Se a divisão utilizar a opção FIXED, esse valor é definido em centavos destinado ao
recebedor. Se a divisão utilizar a opção PERCENTAGE, esse valor é o percentual do montante total
destinado ao recebedor. Valor em centavos do montante destinado ao recebedor. Apenas números
inteiros positivos.
Exemplo: 150099 (Equivalente à R$ 1.500,99).
account objeto
Contém informações das contas dos recebedores participantes da divisão de pagamento.
id String (41 caracteres)
Identificador único da conta PagBank do recebedor.
configurations objeto
Contém informações das configurações dos recebedores participantes da divisão.
custody objeto
Contém informações das configurações de custódia.
apply Boolean
Define se a transação terá custódia.
Exemplo: true
reason String (255 caracteres)
Descrição opcional para cada recebedor participante da divisão do pagamento.
Exemplo: Exemplo de descrição.
notification_urls Array of Object
Contém as URLs que receberão as notificações do pedido (por ora, somente aceitamos uma url apenas. Aceitaremos
mais URLs em breve.)
charges Array of Object
Representa todos os dados disponíveis em uma cobrança, ou seja, na iniciação de um pagamento.
id String (41 caracteres)
Identificador da cobrança PagBank.
Exemplo: CHAR_67FC568B-00D8-431D-B2E7-755E3E6C66A0
status String (1-64 caracteres)
Status da cobrança.
AUTHORIZED
indica que a cobrança está pré-autorizada.PAID
indica que a cobrança está paga (capturada).IN_ANALYSIS
indica que o comprador optou por pagar com um Cartão de Crédito e o PagBank
está analisando o risco da transação.DECLINED
Indica que a cobrança foi negada pelo PagBank ou Emissor.CANCELED
indica que a cobrança foi cancelada.WAITING
Indica que a cobrança está aguardando pagamento.
created_at Datetime
Data e horário em que foi criada a cobrança.
Exemplo: 2023-02-08T15:15:11.881-03:00
paid_at Datetime
Data e horário em que a cobrança foi paga (capturada).
Exemplo: 2023-02-08T15:15:12.000-03:00
reference_id String (1-64 caracteres)
Identificador único atribuído para a cobrança.
Exemplo: Referência da cobrança
description String (1-64 caracteres)
Descrição da cobrança.
Exemplo: Descrição da cobrança
amount Object
Contém as informações do valor a ser cobrado.
value Int (9 caracteres)
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
summary Object
Contém um resumo de valores da cobrança.
total Int (9 caracteres)
Valor total da cobrança.
Exemplo: 150099
paid Int (9 caracteres)
Valor que foi pago na cobrança.
Exemplo: 150099
refunded Int (9 caracteres)
Valor que foi devolvido da Cobrança.
Exemplo: 0
payment_response Object
Contém informações de resposta do provedor de pagamento.
code Int (5 caracteres)
Código PagBank que indica o motivo da resposta de autorização no pagamento, tanto para pagamento
autorizado, quanto para negado.
Exemplo: 20000
message String (5-100 caracteres)
Mensagem amigável descrevendo motivo da não aprovação ou autorização da cobrança. Compatível com o
padrão ABECS - Normativo
21.
Exemplo: SUCESSO
reference String (4-20 caracteres)
NSU da autorização, caso o pagamento seja aprovado pelo Emissor.
Exemplo: 032416400102
payment_method Object
Contém as informações do método de pagamento da cobrança.
type ENUM
Indica o método de pagamento usado na cobrança.
Valores de ENUM:
CREDIT_CARD
ou DEBIT_CARD
se o método de pagamento utilizado for Cartão de
Crédito, Cartão de Débito ou Token de Bandeira. Obrigatório o envio do objeto
payment_method.card
.
BOLETO
se o método de pagamento utilizado for Boleto. Obrigatório o envio do objeto
payment_method.boleto
. PIX
se o método de pagamento utilizado for Pix. O objeto
payment_method.pix
será criado no pagamento do qr code .
installments Int (2 caracteres)
Quantidade de parcelas. Obrigatório para o método de
pagamento Cartão de Crédito.
Exemplo: 06
capture Boolean
Parâmetro que indica se uma transação de Cartão de Crédito deve ser apenas pré-autorizada (reserva o
valor da cobrança no cartão do cliente de 6 á 29 dias) ou se a transação deve ser capturada automaticamente
(cobrança realizada em apenas um passo). Obrigatório para o método de
pagamento Cartão de Crédito. Função indisponível para o método de pagamento Cartão de Débito e Token de
Bandeira (débito).
Informar VISA
, MASTERCARD
, AMEX
,
ELO
.
VISA
, MASTERCARD
,
ELO
.
true
para cobrança em único passo. Informar false
para
pré-autorizar.
capture_before Datetime
Data e horário limite para que seja feita a captura em uma transação com o status
AUTHORIZED
.
Exemplo: 2023-02-18T15:15:11.881-03:00
MASTERCARD
,VISA
e ELO
permitirá à captura em até 29 dias para
MCCs permitidos pelas bandeiras. Lista de
MCCs disponíveis. Demais bandeiras
permitirá à captura em até 6 dias.
soft_descriptor String (1-22 caracteres)
Parâmetro responsável pelo que será exibido como Nome na Fatura do cliente. Aplicável no momento apenas para
Cartão de crédito. Não permite caracteres especiais (acentuações serão substituídas por caracteres sem
acentos, demais caracteres especiais serão removidos).
Exemplo: IntegraçãoPagBank
card Object
Contém os dados de Cartão de Crédito, Cartão de Débito e Token de Bandeira. Obrigatório para o método de
pagamento Cartão de Crédito, Cartão de Débito e Token de Bandeira.
id String (41 caracteres)
Identificador PagBank do Cartão de Crédito salvo (Cartão Tokenizado pelo PagBank). Função indisponível para o método
de pagamento Cartão de Débito e Token de Bandeira.
Exemplo: CARD_CCFE8D12-79E9-4ADF-920B-A54E51D8DA6E
number String (14-19 caracteres)
Número do Cartão de Crédito ou Cartão de Débito.
Exemplo: 4111111111111111
network_token String (14-19 caracteres)
Número do Token de Bandeira.
Exemplo: 1234567890000000
exp_month Int (1/2 caracteres)
Mês de expiração do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 12
exp_year Int (3/4 caracteres)
Ano de expiração do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 2026
security_code String (3/4 caracteres)
Código de Segurança do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 2026
store Boolean
Indica se o cartão deverá ser armazenado no PagBank para futuras compras. Função indisponível para o método
de pagamento Cartão de Débito e Token de Bandeira.
Informar false
ou omitir este parâmetro fará com que o cartão não seja
armazenado. Informar true
fará com que o cartão seja armazenado. Na resposta da
requisição irá receber o token do cartão em payment_method.card.id
.
brand String (20 caracteres)
Bandeira do cartão.
Exemplo: visa
product String (20 caracteres)
Retornado quando um Cartão de Crédito foi do tipo PRE_PAID.
Exemplo:
first_digits Int (6 caracteres)
Seis primeiros números do Cartão ou Token de Bandeira (BIN).
Exemplo: 411111
last_digits Int (4 caracteres)
Quatro últimos números do Cartão ou Token de Bandeira.
Exemplo: 1111
holder Object
Contém as informações do portador do Cartão de Crédito, Cartão de Débito e Token de Bandeira.
name String (1-30 caracteres)
Nome do portador do Cartão de Crédito, Cartão de Débito e Token de Bandeira.
Exemplo: Jose 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 Bandeira.
Exemplo: 12345678910
token_data Object
Contém os dados adicionais de Tokenização de Rede. Deve ser enviado quando um Cartão
de Crédito ou Débito tokenizado pelas bandeiras Visa ou Mastercard é utilizado.
requestor_id String(11)
Identificador de quem gerou o Token de Bandeira (Token Requestor).
Exemplo: 12345678901
wallet ENUM
Tipo de carteira que armazenou o Token de Bandeira.
Valores de ENUM:
APPLE_PAY
GOOGLE_PAY
SAMSUNG_PAY
MERCHANT_TOKENIZATION_PROGRAM
cryptogram String(40)
Criptograma gerado pela bandeira.
Exemplo:
ecommerce_domain String(150)
Identificador do domínio de origem da transação, comumente caracterizado em um formato de domínio
reverso.
Exemplo: br.com.pagbank
assurance_level Int(2)
Conteúdo que indica o nível de confiança do token de rede.
Exemplo: 99
authentication_method Object
Contém os dados adicionais de autenticação vinculados à uma transação. Obrigatório quando
payment_method.type
= DEBIT_CARD
.
payment_method.type
= DEBIT_CARD
. type ENUM
Indica o método de autenticação utilizado na cobrança. Condicional para Token de
Bandeira ELO.
Valores de ENUM:
THREEDS
se o método de autenticação utilizado for 3DS.INAPP
se o método de autenticação utilizado for InApp.
cavv String(80)
Identificador único gerado em cenário de sucesso de autenticação do cliente.
Exemplo: BwABBylVaQAAAAFwllVpAAAAAAA=
eci String(2)
Indicador E-Commerce retornado quando ocorre uma autenticação. Corresponde ao resultado da
autenticação.
Exemplo: 01
xid String(80)
Identificador de uma transação de um MPI - Recomendado para a bandeira VISA. Condicional para 3DS.
Exemplo: BwABBylVaQAAAAFwllVpAAAAAAA=
version String(10)
Versão do protocolo 3DS utilizado na autenticação.
Exemplo: 2.0.1
dstrans_id String(80)
ID da transação gerada pelo servidor de diretório durante uma autenticação - Recomendado para a
bandeira Mastercard. Condicional para 3DS.
Exemplo: DIR_SERVER_TID
status String(80)
Status de uma autenticação 3DS.
Exemplo: AUTHENTICATED
boleto Object
Contém os dados para geração do Boleto.
due_date String (10 caracteres)
Data de vencimento do Boleto. Formato: “yyyy-MM-dd”
Exemplo: 2023-02-10
instruction_lines Object
Contém as linhas de instrução do boleto.
line_1 String (1-75 caracteres)
Primeira linha de instruções sobre o pagamento do Boleto.
Exemplo: Pagamento processado para DESC Fatura
line_2 String (1-75 caracteres)
Segunda linha de instruções sobre o pagamento do Boleto.
Exemplo: Via PagBank
holder Object
Contém as as informações do responsável pelo pagamento do Boleto.
name String (1-30 caracteres)
Nome do responsável pelo pagamento do Boleto.
Exemplo: Jose da Silva
tax_id String (11/14 caracteres)
Número do documento do responsável pelo pagamento do Boleto.
Exemplo: 12345678902
email String (10-255 caracteres)
E-mail do responsável pelo pagamento do Boleto.
Exemplo: [email protected]
address Object
Contém informações do endereço do dono da conta ou sócio da empresa.
street String (1-160 caracteres)
Rua do endereço.
Exemplo: Avenida Brigadeiro Faria Lima
number String (1-20 caracteres)
Número do endereço.
Exemplo: 1384
complement String (1-40 caracteres)
Complemento do endereço.
Exemplo: Casa
locality String (1-60 caracteres)
Bairro do endereço.
Exemplo: Pinheiros
city String (1-90 caracteres)
Cidade do endereço.
Exemplo: São Paulo
region String (1-50 caracteres)
Nome do Estado.
Exemplo: São Paulo
region_code String (2 caracteres)
Código do Estado (Padrão ISO
3166-2).
Exemplo: SP
country String (1-50 caracteres)
País do endereço (Padrão ISO
3166-1 alpha-3).
Exemplo: BRA
postal_code String (8 caracteres)
CEP do endereço.
Exemplo: 01452002
pix Object
Contém os dados do pagamento do Pix.
end_to_end_id String
Id fim a fim da transação.
Exemplo: ffab77a6818042e292e9bc1d0a51dbf2
holder Object
Contém informações do pagador.
name String
Nome do pagador.
Exemplo: José da Silva
tax_id String
Documento do pagador. CPF (mascarado) / CNPJ.
Exemplo: ***534218**
recurring Object
Contém as informações da recorrência. Os clientes que possuem recorrência própria devem utilizar esse
parâmetro para indicar ao PagBank que a cobrança está relacionada a um pagamento recorrente.
A utilização desse parâmetro não está vinculada à API de Pagamento Recorrente do PagBank.
A utilização desse parâmetro não está vinculada à API de Pagamento Recorrente do PagBank.
type ENUM
Indica se a cobrança é proveniente de uma recorrência.
Valores de ENUM:
INITIAL
para a primeira cobrança de uma recorrência.SUBSEQUENT
para as cobranças subsequentes de uma recorrência.UNSCHEDULED
para credenciais armazenadas sem data e valor fixo (somente iniciadas pelo comprador)STANDING ORDER
para cobranças com data fixa e valores variáveis.
sub_merchant Object
Contém os dados do sub lojista, usado por sub-adquirentes para transações com Cartão de Crédito.
Usado apenas por sub-adquirentes autorizados
reference_id String (15 caracteres)
Identificador próprio referente ao lojista atribuído na plataforma do sub-adquirente.
Exemplo: ID123456789
name String (60 caracteres)
Razão social do lojista na plataforma do sub-adquirente em caso de pessoa jurídica. Em casos de pessoa
física, nome completo do lojista na plataforma do sub-adquirente.
Exemplo: João Souza
tax_id String (11 ou 14 caracteres)
Número do documento (CPF ou CNPJ) do lojista na plataforma do sub-adquirente. Apenas números devem ser informados
(com ou sem máscara).
Exemplo: 12345678908
mcc String (4 caracteres)
Código de atuação comercial do lojista (merchant category code) na plataforma do sub-adquirente. Apenas números devem ser informados.
Bloqueio padrão para MCC de alto risco.
Exemplo: 0763
address Object
Contém as informações de endereço do lojista na plataforma do sub-adquirente.
street String (1-160 caracteres)
Rua do endereço.
Exemplo: Avenida Brigadeiro Faria Lima
number String (1-20 caracteres)
Número do endereço.
Exemplo: 1384
complement String (1-40 caracteres)
Complemento do endereço.
Exemplo: Casa
locality String (1-60 caracteres)
Bairro do endereço.
Exemplo: Pinheiros
city String (1-90 caracteres)
Cidade do endereço.
Exemplo: São Paulo
region String (1-50 caracteres)
Nome do Estado.
Exemplo: São Paulo
region_code String (2 caracteres)
Código do Estado (Padrão ISO 3166-2).
Exemplo: SP
country String (1-50 caracteres)
País do endereço (Padrão ISO 3166-1
alpha-3).
Exemplo: BRA
postal_code String (8 caracteres)
CEP do endereço.
Exemplo: 01452002
phone Object
Contém uma lista de telefones de contato do lojista na plataforma do sub adquirente. É preciso ser informado para
transações com a bandeira ELO.
country Int (3 caracteres)
Código de operadora do País (DDI).
Exemplo: 55
area Int (2 caracteres)
Código de operadora local (DDD).
Exemplo: 021
number Int (8-9 caracteres)
Número do telefone.
Exemplo: 123456789
type String (ENUM)
Indica o tipo de telefone.
Valores de ENUM:
MOBILE
se for um telefone celular.BUSINESS
se for um telefone comercial.HOME
se for um telefone residencial.
notification_urls Array of String
URLs que serão notificadas em toda alteração ocorrida na cobrança.
Necessário que seja em ambiente seguro com SSL (HTTPS).
Exemplo: https://meusite.com/notificacoes
metadata Map
Conjunto de pares de valores-chave que você pode anexar a um objeto. Isso pode ser útil para armazenar
informações adicionais sobre o objeto em um formato estruturado.
links Array of Object
Contém as informações de links relacionado ao recurso.
rel ENUM
Indica o tipo do relacionamento ao recurso.
Exemplo: SELF
href String (5-2048 caracteres)
Endereço HTTP do recurso.
Exemplo:
https://sandbox.api.pagseguro.com/charges/CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD
media String (11-64 caracteres)
Tipo de mídia ao qual o link responde ou aceita.
Exemplo: application/json
type ENUM
Método HTTP em uso.
Valores de ENUM:
GET
POST
DELETE
PUT
splits Object
Contém informações da divisão de pagamento.
method ENUM
Define se os valores da divisão serão informados em valores brutos (FIXED) ou em porcentagens
(PERCENTAGE) do valor total da transação.
Valores de ENUM:
FIXED
PERCENTAGE
receivers Array de objetos
Contém a lista de recebedores participantes da divisão de pagamento. O número de objetos será igual ao
número de participantes.
amount objeto
Contém informações dos valores dos recebedores participantes da divisão.
value Int (9 caracteres)
Se a divisão utilizar a opção FIXED, esse valor é definido em centavos destinado ao
recebedor. Se a divisão utilizar a opção PERCENTAGE, esse valor é o percentual do montante total
destinado ao recebedor. Valor em centavos do montante destinado ao recebedor. Apenas números
inteiros positivos.
Exemplo: 150099 (Equivalente à R$ 1.500,99).
account objeto
Contém informações das contas dos recebedores participantes da divisão de pagamento.
id String (41 caracteres)
Identificador único da conta PagBank do recebedor.
configurations objeto
Contém informações das configurações dos recebedores participantes da divisão.
custody objeto
Contém informações das configurações de custódia.
apply Boolean
Define se a transação terá custódia.
Exemplo: true
chargeback objeto
Contém informações das configurações de chargeback.
charge_transfer objeto
Contém informações da configuração de repasse de chargeback.
percentage Number
Porcentagem referente ao valor do chargeback que deve ser repassado para o recebedor.
Atualmente, só é permitido repassar a cobrança do chargeback para um recebedor,
consequentemente, a porcentagem deve ser sempre igual à 100.
Exemplo: 100
reason String (255 caracteres)
Descrição opcional para cada recebedor participante da divisão do pagamento.
Exemplo: Exemplo de descrição.
links Array of Object
Contém as informações de links relacionado ao recurso.
rel ENUM
Indica o tipo do relacionamento ao recurso.
Exemplo: SELF
href String (5-2048 caracteres)
Endereço HTTP do recurso.
Exemplo:
https://sandbox.api.pagseguro.com/charges/CHAR_D32A01A9-92A6-4755-B21D-7B6A1291F7AD
media String (11-64 caracteres)
Tipo de mídia ao qual o link responde ou aceita.
Exemplo: application/json
type ENUM
Método HTTP em uso.
Valores de ENUM:
GET
POST
DELETE
PUT
wallet Object
Contém os dados referentes a Wallet que está transacionando aquele pagamento. * Fluxo disponível apenas para
transações de Wallets. *
type String (10 caracteres)
Nome da wallet utilizada na transação.
Exemplo: GOOGLE_PAY
key String
Criptograma do cartão enviado pela wallet.
Exemplo:
"{\"signature\":\"MEUCIQDHvDj8srv0WDR7gTY6pVXzbxI9zyfVf51faFNWbdcSKwIgR4uBoacP3M1xXoiJldCSkrqE7FlYk8neH3+ws5j9yM4\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE7BTuiSa1PsuZb7XHkpfmDxtDf5GBC1S+6OmyMD3norKhNW2xBsmXI5mFsZ1sIoh+S0XJJfGsSguuOcXYEvSVRg\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1715967637711\\\"}\",\"signatures\":[\"MEUCIQC5BL11cdKLzEqg1Oz2OCtcHPPp12OUz/sza70EUtzX+QIgFb2oAXdnA9pF0ZySTeSpzAjq+PVDubZmdH/cBxJ3lx4\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"yIVMmvdOfN+Vk7pBdM9kPNWKh9oNAGsX+98vOTWMILil7qVyrTbK3WBmFdGP/ZQ9z1eXmq6o6xBJFCPJ9hKTJ+eIZCA5UlLzFoFH5XmJss1Y9sVhcv5K1m+bLTZy7c9qXxitSUil+TaLWTkw42GKmG5nc9MoDRcvizPk3P4bPbeZuL0oK4LeVJz15m5+k3ADQzP+d4BslGjv1SwLR9jnks4L92iv6Mrxlj5mVfJxSPlGLPsYVqoyPRxIEtzZ3GrWtxhEU60EaTFMOWcZ3g60RYdAq64shc4hqiiJGvuGS5R27NgRZgWRO0N/1GxxzAiOh73B448iUvGmMmXOl1Y9mZp6j1mqw0OR5JBtW8H/61gNoAgslj7eJ3AZj1/bB6iVbc9pnqmw03qQWz8annvPoEDWkp60Tm84yDLo4CubB7cqA/DwhP3w9mmM4b78jm09rDnIzDX72spWp63SqbAqRBGCRIrq+uk//zvK582ZbQpupMGzYecz1faKLESs5efsnTbADb6mq4IgCX0wXTc+cQzi9ods356nK/r/1OiR9i1y6zFp8yp4XtFGbj96/mztjbaeuBXqhW7cQRcRCoT8I2k3RQ\\\\u003d\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BLLrVSr/lt1hxnYEKzXJ0vwLv5LI8UWZpNNQEeo3rjVTlj/l46/xuIKgKDVGYepb7buwZ5ZuxOc4PqAWguCg+1A\\\\u003d\\\",\\\"tag\\\":\\\"XlhrDBFo1GbRR0zF9zCAjDVlY2vd3ci71D/yHOHNbj4\\\\u003d\\\"}\"}"
payment_method Object
Contém as informações do método de pagamento da cobrança.
type ENUM
Indica o método de pagamento usado na cobrança.
Valores de ENUM:
CREDIT_CARD
ou DEBIT_CARD
se o método de pagamento utilizado for
Cartão de
Crédito, Cartão de Débito ou Token de Bandeira. Obrigatório o envio do
objeto
payment_method.card
.
BOLETO
se o método de pagamento utilizado for Boleto. Obrigatório o envio do
objeto
payment_method.boleto
. PIX
se o método de pagamento utilizado for Pix. O objeto
payment_method.pix
será criado no pagamento do qr code .
installments Int (2 caracteres)
Quantidade de parcelas. Obrigatório para o método de
pagamento Cartão de Crédito.
Exemplo: 06
capture Boolean
Parâmetro que indica se uma transação de Cartão de Crédito deve ser apenas pré-autorizada (reserva
o
valor da cobrança no cartão do cliente de 6 á 29 dias) ou se a transação deve ser capturada
automaticamente
(cobrança realizada em apenas um passo). Obrigatório para o método de
pagamento Cartão de Crédito. Função indisponível para o método de pagamento Cartão de Débito e Token
de
Bandeira (débito).
Informar VISA
, MASTERCARD
, AMEX
,
ELO
.
VISA
, MASTERCARD
,
ELO
.
true
para cobrança em único passo. Informar false
para
pré-autorizar.
capture_before Datetime
Data e horário limite para que seja feita a captura em uma transação com o status
AUTHORIZED
.
Exemplo: 2023-02-18T15:15:11.881-03:00
MASTERCARD
,VISA
e ELO
permitirá à captura em até 29 dias
para
MCCs permitidos pelas bandeiras. Lista
de
MCCs disponíveis. Demais bandeiras
permitirá à captura em até 6 dias.
soft_descriptor String (1-22 caracteres)
Parâmetro responsável pelo que será exibido como Nome na Fatura do cliente. Aplicável no momento apenas para
Cartão de crédito. Não permite caracteres especiais (acentuações serão substituídas por caracteres sem
acentos, demais caracteres especiais serão removidos).
Exemplo: IntegraçãoPagBank
card Object
Contém os dados de Cartão de Crédito, Cartão de Débito e Token de Bandeira. Obrigatório para o método de
pagamento Cartão de Crédito, Cartão de Débito e Token de Bandeira.
id String (41 caracteres)
Identificador PagBank do Cartão de Crédito salvo (Cartão Tokenizado pelo PagBank). Função indisponível para o
método
de pagamento Cartão de Débito e Token de Bandeira.
Exemplo: CARD_CCFE8D12-79E9-4ADF-920B-A54E51D8DA6E
number String (14-19 caracteres)
Número do Cartão de Crédito ou Cartão de Débito.
Exemplo: 4111111111111111
network_token String (14-19 caracteres)
Número do Token de Bandeira.
Exemplo: 1234567890000000
exp_month Int (1/2 caracteres)
Mês de expiração do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 12
exp_year Int (3/4 caracteres)
Ano de expiração do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 2026
security_code String (3/4 caracteres)
Código de Segurança do Cartão de Crédito, Cartão de Débito ou Token de Bandeira.
Exemplo: 2026
store Boolean
Indica se o cartão deverá ser armazenado no PagBank para futuras compras. Função indisponível para o
método
de pagamento Cartão de Débito e Token de Bandeira.
Informar false
ou omitir este parâmetro fará com que o cartão não seja
armazenado. Informar true
fará com que o cartão seja armazenado. Na resposta da
requisição irá receber o token do cartão em payment_method.card.id
.
brand String (20 caracteres)
Bandeira do cartão.
Exemplo: visa
product String (20 caracteres)
Retornado quando um Cartão de Crédito foi do tipo PRE_PAID.
Exemplo:
first_digits Int (6 caracteres)
Seis primeiros números do Cartão ou Token de Bandeira (BIN).
Exemplo: 411111
last_digits Int (4 caracteres)
Quatro últimos números do Cartão ou Token de Bandeira.
Exemplo: 1111
holder Object
Contém as informações do portador do Cartão de Crédito, Cartão de Débito e Token de Bandeira.
name String (1-30 caracteres)
Nome do portador do Cartão de Crédito, Cartão de Débito e Token de Bandeira.
Exemplo: Jose 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 Bandeira.
Exemplo: 12345678910
token_data Object
Contém os dados adicionais de Tokenização de Rede. Deve ser enviado quando um
Cartão
de Crédito ou Débito tokenizado pelas bandeiras Visa ou Mastercard é utilizado.
requestor_id String(11)
Identificador de quem gerou o Token de Bandeira (Token Requestor).
Exemplo: 12345678901
wallet ENUM
Tipo de carteira que armazenou o Token de Bandeira.
Valores de ENUM:
APPLE_PAY
GOOGLE_PAY
SAMSUNG_PAY
MERCHANT_TOKENIZATION_PROGRAM
cryptogram String(40)
Criptograma gerado pela bandeira.
Exemplo:
ecommerce_domain String(150)
Identificador do domínio de origem da transação, comumente caracterizado em um formato de
domínio
reverso.
Exemplo: br.com.pagbank
assurance_level Int(2)
Conteúdo que indica o nível de confiança do token de rede.
Exemplo: 99
authentication_method Object
Contém os dados adicionais de autenticação vinculados à uma transação. Obrigatório quando
payment_method.type
= DEBIT_CARD
.
payment_method.type
= DEBIT_CARD
. type ENUM
Indica o método de autenticação utilizado na cobrança. Condicional para Token de
Bandeira ELO.
Valores de ENUM:
THREEDS
se o método de autenticação utilizado for 3DS.INAPP
se o método de autenticação utilizado for InApp.
cavv String(80)
Identificador único gerado em cenário de sucesso de autenticação do cliente.
Exemplo: BwABBylVaQAAAAFwllVpAAAAAAA=
eci String(2)
Indicador E-Commerce retornado quando ocorre uma autenticação. Corresponde ao resultado da
autenticação.
Exemplo: 01
xid String(80)
Identificador de uma transação de um MPI - Recomendado para a bandeira VISA. Condicional para 3DS.
Exemplo: BwABBylVaQAAAAFwllVpAAAAAAA=
version String(10)
Versão do protocolo 3DS utilizado na autenticação.
Exemplo: 2.0.1
dstrans_id String(80)
ID da transação gerada pelo servidor de diretório durante uma autenticação - Recomendado para
a
bandeira Mastercard. Condicional para 3DS.
Exemplo: DIR_SERVER_TID
status String(80)
Status de uma autenticação 3DS.
Exemplo: AUTHENTICATED
boleto Object
Contém os dados para geração do Boleto.
due_date String (10 caracteres)
Data de vencimento do Boleto. Formato: “yyyy-MM-dd”
Exemplo: 2023-02-10
instruction_lines Object
Contém as linhas de instrução do boleto.
line_1 String (1-75 caracteres)
Primeira linha de instruções sobre o pagamento do Boleto.
Exemplo: Pagamento processado para DESC Fatura
line_2 String (1-75 caracteres)
Segunda linha de instruções sobre o pagamento do Boleto.
Exemplo: Via PagBank
holder Object
Contém as as informações do responsável pelo pagamento do Boleto.
name String (1-30 caracteres)
Nome do responsável pelo pagamento do Boleto.
Exemplo: Jose da Silva
tax_id String (11/14 caracteres)
Número do documento do responsável pelo pagamento do Boleto.
Exemplo: 12345678902
email String (10-255 caracteres)
E-mail do responsável pelo pagamento do Boleto.
Exemplo: [email protected]
address Object
Contém informações do endereço do dono da conta ou sócio da empresa.
street String (1-160 caracteres)
Rua do endereço.
Exemplo: Avenida Brigadeiro Faria Lima
number String (1-20 caracteres)
Número do endereço.
Exemplo: 1384
complement String (1-40 caracteres)
Complemento do endereço.
Exemplo: Casa
locality String (1-60 caracteres)
Bairro do endereço.
Exemplo: Pinheiros
city String (1-90 caracteres)
Cidade do endereço.
Exemplo: São Paulo
region String (1-50 caracteres)
Nome do Estado.
Exemplo: São Paulo
region_code String (2 caracteres)
Código do Estado (Padrão ISO
3166-2).
Exemplo: SP
country String (1-50 caracteres)
País do endereço (Padrão
ISO
3166-1 alpha-3).
Exemplo: BRA
postal_code String (8 caracteres)
CEP do endereço.
Exemplo: 01452002
pix Object
Contém os dados do pagamento do Pix.
end_to_end_id String
Id fim a fim da transação.
Exemplo: ffab77a6818042e292e9bc1d0a51dbf2
holder Object
Contém informações do pagador.
name String
Nome do pagador.
Exemplo: José da Silva
tax_id String
Documento do pagador. CPF (mascarado) / CNPJ.
Exemplo: ***534218**