🚀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",
  "email": "[email protected]",
  "amount": 1.10,
  "expires": 3600,
  "custom_id": "PN123",
  "custom_data": {
    "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

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

Request Body

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

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

{
    "http_code": 200,
    "success": true,
    "info": {
        "result": "pix_transaction_created",
        "message": "The Pix transaction was successfully created.",
        "data": {
            "calendario": {
                "criacao": "2026-01-01T11:05:53.009Z",
                "expiracao": 3600
            },
            "devedor": {
                "cnpj": "00000000000000",
                "nome": ""
            },
            "valor": {
                "modalidadeAlteracao": 0,
                "original": 1.1
            },
            "chave": "4cf1bb22-71c1-4530-b735-d240c3c0f88a",
            "solicitacaoPagador": "Cobrança de assinatura #PN123",
            "infoAdicionais": [],
            "txid": "2ce3608c77264388b956c039",
            "location": "brcode.infra.com/v2/8657085674d44db288430cftb155ca62",
            "revisao": 0,
            "status": "ATIVA",
            "pixCopiaECola": "00010301021226190014br.gov.bcb.pix2557brcode.infra.com/v2/1652085674d33db965430cfab255ba405204000053039865802BR59254Pay Finance Prestadora d6106Recife62070503***6304F9E1",
            "code": 201
        }
    }
}

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.