🚀Criando uma transação
Esta página contém instruções de como solicitar a criação de uma transação na API da 4P Finance.
Serviço
• Envia um JSON contendo os dados necessários para a criação de uma cobrança imediata.
• Retorna um JSON contendo os dados da cobrança criada, inclusive Pix Copia-e-Cola.
Solicitação de registro/transação
A requisição para realizar a criação/registro de uma transação deverá ter como corpo da solicitação JSON as informações necessárias para registrar a transação.
Exemplo de payload
{
"cpf": "01234567899", // Troque esta chave para "cnpj" no caso de CNPJ / Pessoa Jurídica.
"email": "usuario@example.com",
"amount": 1.10,
"expires": 3600,
"custom_id": "PN123",
"custom_data": {
"chain": "Arbitrum", // Opcional (Default: Arbitrum)
"asset": "USDT", // // Opcional (Default: USDT)
"receiver_wallet": "0x4328...edFB995B6I"
},
"description": "Cobrança de assinatura #PN123",
"notification_url": "https://seu-dominio-webhook.com.br/param=tes&token=abcd-dfg"
}Requisição
Solicita a criação/registro de uma transação.
PUT https://api.4p.finance/v1/pix/transaction
Realiza a solicitação do registro de uma transação.
Headers
x-api-key*
String
Sua chave API.
Request Body
expires*
Integer
T empo de vida da cobrança, em segundos, a partir da data de criação. Deve ser igual ou maior do que 300. Máximo: 259200 segundos.
amount*
Number
Valor original da cobrança. Deve ser informado um valor maior ou igual a 0.01, com casas decimais.
custom_id *
String
Id da transação ou Id do Pix. Permite que o usuário recebedor faça a conciliação dos pagamentos. Deve ser único por transação PIX e conter no máximo 255 caracteres.
description*
String
Representa um texto ( campo solicitacaoPagador do PIX ), a ser apresentado ao usuário pagador para que ele possa digitar uma informação correlata, em formato livre, a ser enviada ao usuário recebedor. Máximo 140 caracteres.
notification_url *
String
URL que receberá as notificações POST encaminhadas pelo serviço de webhook logo após o PIX ser pago.
custom_data*
Object
Objeto pai para dados customizados.
receiver_wallet*
String
Chave filha de custom_data para envio da carteira do cliente pagador do PIX, no qual receberá as criptomoedas. Usado para compras de criptomoedas através de API PIX para (P2P).
Retorno
Observe que o objeto data contém os dados do PIX incluindo chave Copia e Cola (pixCopiaECola). Ao criar uma cobrança Pix, o usuário recebedor obtém as informações para a geração da imagem do QR Code dinâmico, juntamente com sua representação em forma de Pix Copia-e-Cola.
Destacamos que a geração da imagem do QR Code não é gerada, e fica a cargo de cada implementador.
Conclusão
Após a confirmação do pagamento, o valor convertido em criptomoeda será enviado automaticamente para a carteira informada no payload da requisição.
O tempo médio para envio e finalização da transação é de aproximadamente 10 segundos, podendo variar de acordo com a rede blockchain selecionada e as condições da própria rede no momento da operação.
Saiba mais sobre as notificações e callbacks na próxima sessão.
Atualizado