🔡Obtendo dados de notificações

Saiba como consultar os dados das notificações enviadas ao seu sistema.

Uma vez que a sua URL de retorno recebeu um POST com o token de notificação da 4P Finance, o seu sistema deverá realizar uma requisição GET para o endpoint /notification/:token que retornará os dados da transação/notificação.

Realiza requisição dos dados da notificação

GET https://api.4p.finance/v1/notification/:token

Realiza uma requisição enviando o token recebido via POST na URL de retorno cadastrada na criação da transação.

Path Parameters

Name	Type	Description
token*	String	Token recebido via POST na sua URL de retorno cadastrada.

Headers

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

200: OK Retorno token recebimento do Pix

{
    "http_code": 200,
    "success": true,
    "info": {
        "data": {
            "id": "936e8ae54933c2f8c10f3908e50be15c",
            "txid": "1ae3808c17364388b956c039",
            "status": "paid",
            "amount": "1.10",
            "description": "Cobrança de assinatura #PN123",
            "payer_info": "Nome do pagador - 123.456.789-00",
            "payment_date_time": "01/01/2026, 11:46:21",
            "created_at": "01/01/2026, 08:05:52",
            "confirmed_at": "01/01/2026, 11:46:25",
            "custom_id": "PN123"
        }
    }
}

200: OK Retorno token envio das criptos

{
    "http_code": 200,
    "success": true,
    "info": {
        "data": {
            "id": "936e8ae54933c2f8c10f3908e50be15c",
            "txid": "1ae3808c17364388b956c039",
            "status": "paid",
            "amount": "1.10",
            "description": "Cobrança de assinatura #PN123",
            "payer_info": "Nome do pagador - 123.456.789-00",
            "payment_date_time": "01/01/2026, 11:46:21",
            "created_at": "01/01/2026, 08:05:52",
            "confirmed_at": "01/01/2026, 11:46:25",
            "custom_id": "PN123",
            "custom_data": {
                "chain_name": "Arbitrum",
                "amount_usdt": "0.20216",
                "receiver_wallet": "0x4328437bf03FFDBb0f64358a6a2947edFB995B6I",
                "transaction_hash": "0x63aaer69c90bafbb11f36b4a1adacedce28b84803e82f7a68b8442357ffe0f33"
            }
        }
    }
}

Importante! Se o seu sistema consulta o token enviado, consideramos que a notificação foi realizada com sucesso. Caso não consulte, tentaremos novamente por até 05 dias.

Ou seja, se houver uma requisição ao endpoint GET /notification/:token, entenderemos que você recebeu o POST com o token de notificação e que o consultou, recebendo como resposta todos os dados informativos sobre a confirmação da transação.

Uma vez que consultou os dados da transação, o seu sistema já pode efetuar a baixa de pagamento, confirmação, ou conclusão da transação.