🚀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": "[email protected]",
    "amount_crypto": 1.10,
    "custom_id": "PN123",
    "custom_data": {
        "asset": "USDT",
        "chain": "Arbitrum"
    },
    "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

Name	Type	Description
x-api-key*	String	Sua chave API.

Request Body

Name	Type	Description
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.

200: OK Retorno após criar/registrar uma transação.

{
    "http_code": 200,
    "success": true,
    "info": {
        "result": "p2p_transaction_cryptopix_created",
        "message": "P2P transaction promise has been created. Please transfer the crypto to the indicated wallet to proceed.",
        "data": {
            "txid": "da75257ce3f19483ef1049fef890a310",
            "amount_crypto": 1.10,
            "asset": "USDT",
            "chain": "arbitrum",
            "amount_brl": 5.49,
            "receiver_wallet": "0x4328...edFB995B6I",
            "expires": 1769608117
        }
    }
}

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.