Visão geral
Chame a API de pagamentos para solicitar métodos de pagamento de host-to-host.
Os parâmetros da API são organizados em objetos distintos para agilizar o processo de pagamento e garantir clareza no tratamento de dados. Cada objeto representa um aspecto específico da transação, facilitando o gerenciamento e a compreensão do fluxo de informações. No entanto, alguns parâmetros são independentes e não fazem parte de nenhum objeto. Abaixo está uma visão geral dos objetos e seus parâmetros correspondentes, bem como os parâmetros autônomos:
Cliente : Representa o indivíduo que faz o pagamento. Este objeto inclui informações críticas sobre o cliente, como seu ID exclusivo, nome, endereço de e-mail e, opcionalmente, seu endereço IP e data de nascimento. O subobjeto customer.document detalha o tipo e o número da identificação oficial do cliente, enquanto o sub objeto customer.address inclui o endereço completo do cliente, que pode ser necessário dependendo do método de pagamento.
Transação : Este objeto contém todos os detalhes essenciais sobre a transação em si, incluindo um ID de transação exclusivo, a moeda usada, o valor total envolvido e, opcionalmente, o tempo até a transação expirar.
Pagamento : Representa o método de pagamento e URLs relacionadas para concluir a transação. Este objeto é crucial para determinar como o cliente pagará e para onde será redirecionado após o pagamento ser concluído.
Valores : Este objeto fornece informações financeiras detalhadas relacionadas à transação. Inclui os valores originais e convertidos, as moedas envolvidas, a taxa de câmbio aplicada e quaisquer taxas associadas à transação.
Parâmetros autônomos, como branch , country , notification_url e redirect_url , não pertencem a nenhum objeto específico. Esses parâmetros fornecem informações adicionais relevantes para a transação, como o local da transação, o código do país, para onde as notificações de pagamento devem ser enviadas e para onde o cliente deve ser redirecionado após concluir o pagamento.
Nossa estrutura de API permanece consistente em diferentes métodos de pagamento e países, facilitando a adaptação à medida que você expande para novas regiões ou integra novos métodos.
Conhecendo os parâmetros utilizados
customer.id
string
Identificador exclusivo para o cliente em seu sistema. Este valor deve permanecer consistente em todas as transações para o mesmo cliente
customer.name
string
O nome completo do cliente que está fazendo o pagamento. Deve corresponder ao nome nos documentos de identificação do cliente
customer.email
string
O endereço de e-mail do cliente. Este será usado para enviar confirmações de pagamento e notificações
customer.phone
string
O número de telefone do cliente, incluindo o código do país. Este parâmetro pode ser opcional ou obrigatório dependendo do método de pagamento usado
customer.birthdate
string
A data de nascimento do cliente, fornecida no formato mm-dd-yyyy
. Este parâmetro pode ser necessário dependendo dos regulamentos do país ou do método de pagamento
customer.document.number
string
O número de identificação oficial do cliente. Normalmente é uma identidade nacional ou outro documento emitido pelo governo
customer.document.type
string
O tipo de documento fornecido pelo cliente. Tipos comuns incluem ID nacional ou carteira de motorista. Lista de documentos permitidos .
customer.address.addres_1
string
O endereço principal do cliente
customer.address.addres_2
string
Informações adicionais de endereço, como número do apartamento ou suíte
customer.address.city
string
A cidade em que o cliente reside
customer.address.country_code
string
O código de país ISO 3166-1 alfa-3 para o endereço do cliente.
customer.address.neightborhood
string
O bairro ou distrito do endereço do cliente
customer.address.number
string
O número da rua do endereço
customer.address.postal_code
string
O código postal ou CEP do endereço do cliente
customer.address.state
string
O estado ou região do endereço do cliente
transaction.id
string
Um identificador exclusivo para a transação. Este ID deve ser gerado pelo seu sistema para rastrear o processo de pagamento específico
transaction.currency
string
A moeda na qual a transação está sendo conduzida. Use códigos de moeda padrão ISO 4217 (por exemplo, USD, BRL).
transaction.amount
decimal (10,2)
O valor total da transação na moeda especificada. Este valor deve ser um valor numérico (use ponto em vez de vírgula) Eg: 300.10
transaction.expire
integer (11)
O tempo em segundos até que a transação expire e não seja mais válida
branch
string
O identificador específico da agência ou local onde a transação está sendo processada, se aplicável
country
string
O código do país onde a transação está ocorrendo. O formato é ISO 3166-1 alpha-3
(por exemplo, BRA para o Brasil).
payment_method
string
O método de pagamento utilizado para a transação, como boleto, PIX...
notification_url
string
A URL para a qual as notificações de pagamento serão enviadas. Certifique-se de que esta URL esteja acessível e configurada para lidar com o formato de notificação
Exemplo de solicitação de método de pagamento de resposta
{
"requestId": "a2435636-5f69-447d-8e22-8382f62ef7dd",
"data": {
"id": "4a79f3b4-8d55-428b-a560-984fedd6f78a",
"status": "pending",
"expires_in": 1722108649,
"payment": {
"method": "picpay",
"qr_code": "00...014COM.JUMPPAGAMENTOS.P2B0164https:\\api-uat.jumppag.com\checkout\JUMPPAGAMENTOS...AY6009SAO PAULXXXXX",
"url": "https:\\app.jumppag.com.br\checkout\JUMPPAGAMENTOS",
"name": "acredicorp", // only payment method is bank_transfer
"code": "090", // only payment method is bank_transfer
"agency": "0250-5", // only payment method is bank_transfer
"account": "12991163", // only payment method is bank_transfer
"account_operation": "Conta Corrente", // only payment method is bank_transfer
"document": "55.921.151/0001-88", // only payment method is bank_transfer
"beneficiary": "Jump Pagamentos" // only payment method is bank_transfer
},
"values": {
"source_total": 7525.47,
"source_currency": "BRL",
"exchanged_total": 7525.47,
"exchanged_currency": "BRL",
"exchange": 1.00,
"fee": 90.5226
}
}
}
Detalhes da resposta
id
Um identificador exclusivo para a resposta gerada pelo sistema de pagamento, usado para rastrear a transação. Pode ser usado para verificar o status do pagamento no endpoint GET /payment/{id}
status
O status atual da transação, como pending
, paid
, denied
,expired
expires_in
O tempo em segundos até que a transação expire e não seja mais válida
payment.method
O método de pagamento usado para a transação, como pix
, bankslip
, picpay
...
payment.url
A URL fornecida ao cliente para concluir o pagamento. Pode ser um redirecionamento para um banco ou gateway de pagamento
payment.qr_code
A string que contém as informações do qrcode. É necessário usar algum recurso de programação para converter esse texto em uma imagem
payment.name
Nome do banco onde o depósito será feito
payment.code
Código brasileiro do banco para onde o depósito será direcionado
payment.agency
Número da agência com dígito de verificação para onde o depósito será direcionado
payment.account
Número da conta com dígito de verificação para onde o depósito será direcionado
payment.account_operation
Seja uma conta poupança ou uma conta corrente. current account
,saving account
payment.document
O documento do proprietário ou o documento da empresa da conta para a qual o depósito será direcionado
payment.beneficiary
Nome do titular da conta para a qual o depósito será direto
values.source_total
O valor total da transação na moeda de origem antes de qualquer troca
values.source_currency
A moeda original da transação conforme especificada na solicitação
values.exchanged_total
O valor total da transação após a conversão de moeda, se aplicável
values.exchanged_currency
A moeda em que o pagamento foi concluído após a conversão
values.exchange
A taxa de câmbio aplicada para converter a moeda de origem para a moeda de destino
values.fee
O valor cobrado pelo nosso serviço para processar a transação
O
payment.qr_code
parâmetro pode ser fornecido em diferentes formatos dependendo do cenário. Você pode receber uma URL e um código QR, ou apenas um deles . No exemplo abaixo, o método de pagamento "pix" inclui um código QR e uma URL. Dependendo da implementação, você pode precisar usar apenas um desses elementos, ou ambos, para facilitar o processo de pagamento.
"payment": {
"method": "pix",
"qr_code": "00...014COM.pix.P2B0164https:\\app.pix.com\checkout\JUMPPAGAMENTOS...AZ6009SAO PAULXXXXX",
"url": "https:\\app.pix.com\checkout\JUMPPAGAMENTOS"
},
Nossa API foi projetada para ser flexível e adaptável , de modo que, à medida que você expande para novas regiões ou adiciona mais métodos de pagamento, você pode facilmente aplicar esses princípios em diferentes implementações.
Se precisar de mais detalhes sobre outros métodos de pagamento ou países, certifique-se de explorar o restante da nossa documentação. Além disso, temos uma seção dedicada de FAQ e suporte para ajudar com perguntas comuns
Atualizado
Isto foi útil?