🚀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 venda imediata.
• Retorna um JSON contendo os dados da conversão criada, inclusive rede, token e carteira para qual os criptoativos deverão ser enviados.
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
{
"person_document": "01234567899",
"email": "usuario@example.com",
"amount_crypto": 1.10,
"custom_id": "PN123",
"custom_data": {
"chain": "Arbitrum",
"asset": "USDT"
},
"sender_wallet": "0x4328...edFB995B6I",
"destination_pix_key": "01234567899",
"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/cryptopix/transaction
Realiza a solicitação do registro de uma transação.
Headers
x-api-key*
String
Sua chave API.
Request Body
custom_id *
String
Id da transação. Permite que o usuário recebedor faça a conciliação dos pagamentos. Deve ser único por transação e conter no máximo 255 caracteres.
destination_pix_key*
String
Chave PIX para qual o valor fiat (BRL) será enviado após o recebimento e conversão dos criptoativos. Caso não seja enviada, o PIX será enviado para chave que deverá ter sido previamente informada.
sender_wallet*
String
Chave para envio da carteira do cliente pagador da qual obrigatoriamente deverá se originar os envio de criptoativos.
notification_url *
String
URL que receberá as notificações POST encaminhadas pelo serviço de webhook logo após ao criptoativos serem enviados e convertidos.
amount_crypto*
Float
Valor original da cobrança em criptoativos. Deve ser informado um valor maior ou igual a 0.01, com casas decimais.
person_document*
String
Número de documento ou identificação do usuário ao qual a transação deverá ser associada, equivalente ao CPF.
custom_data*
Object
Objeto pai para dados relacionados a rede e token que serão alvo da transação.
Retorno
Observe que o objeto data contém as informações da transação, incluindo a carteira de destino dos criptoativos (receiver_wallet). É necessário que os ativos sejam enviados exatamente no valor informado para essa carteira, a partir da carteira do cliente pagador indicada no momento da criação da transação.
Destacamos que será retornada no data uma chave expire, ela representa o período máximo de monitoramento da transação. Após essa expiração, uma nova transação deverá ser criada antes do envio dos criptoativos.
Conclusão
Após a confirmação do recebimento das criptomoedas, o valor convertido em fiat será enviado automaticamente para o PIX informado no payload da requisição ou anteriormente associado a conta do usuário.
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