Pular para o conteúdo principal

Procedimentos de Conciliação

Pagamentos feitos diretamente a conta, sem o uso do QRCODE gerado:​

Essa consulta deverá ser realizada no endpoint da Transfeera informando o id do pagamento (end2end_id), como por exemplo: E228964312023041102241WLd09c9068

Você obterá uma resposta como:

{
    "id": "e9e00d30-6f0d-4689-a9df-1632af2e6e6e",
    "value": 0.5,
    "end2end_id": "E228964312023041102241WLd09c9068",
    "txid": null,
    "type": "DEPOSIT",
    "integration_id": null,
    "receipt_file_url": "https://api.url.com/xyz/abcd/4G2nhnRse5gtgWvZ6A22EAguW70Yvwnvxard6dmzxq8slzl9Oagrf9RwTtqHxNNgZffsAfr5fDvRwsYoTWZbTr864667c8ee9a05",
    "pix_key": null,
    "pix_description": null,
    "payer": {
        "name": "Nome do cliente",
        "document": "***.012.023-**",
        "account_type": "CONTA_CORRENTE",
        "account": "71766730",
        "account_digit": "3",
        "agency": "0001",
        "bank": {
            "name": "Picpay servicos s.a.",
            "code": "380",
            "ispb": "22896431"
        }
    },
    "receiver": {
        "name": "SAFE WAY GESTAO DE RECURSOS FINANCEIROS LTDA",
        "document": "4003340500240",
        "account_type": "CONTA_PAGAMENTO",
        "account": "07200400",
        "account_digit": "0",
        "agency": "0001",
        "bank": {
            "name": "Transfeera Pagamentos S.A.",
            "code": null,
            "ispb": "27084098"
        }
    }
}

Verifique se na resposta os atributos txid e integration_id são nulos.

No exemplo acima, ambos os atributos estão nulos, portanto o pagamento deverá ser devolvido.

Importante

Para toda devolução é necessário informar o end2endId e o valor total da transação recebida.

Pagamentos que não foram devolvidos​

Agora consultando o id do pagamento (end2end_id) E22896431202304021140rfKm8mIwtjm, obteremos uma resposta como:

{
    "id": "747ac8a8-230a-47c1-9909-cfc9430da5d4",
    "value": 20,
    "end2end_id": "E22896431202304021140rfKm8mIwtjm",
    "txid": "b7a6922117a11bc81da08940bc8a11b2",
    "type": "DEPOSIT",
    "integration_id": "1623756",
}

Caso exista txid e/ou integration_id, significa que o pagamento foi criado corretamente, como no exemplo acima.

Consultando o identificador da cobrança (txid):​

{
    "id": "1319a96d-a6f4-4d6c-9fd8-7f192bf1af2c",
    "qrcode_type": "COBRANCA_IMEDIATA",
    "status": "CONCLUIDA",
    "txid": "b7a6922117a11bc81da08940bc8a11b2",
    "integration_id": "1623756",
    "original_value": 20,
    "value_change_mode": "VALOR_FIXADO",
    "withdraw": null,
    "change": null,
    "expiration": 480,
    "payer_question": "Depósito para 7 Games",
    "payer": {
        "name": "PAULA ROSANA CRISTINA DA SILVA",
        "document": "03047675651"
    },
    "additional_info": null,
    "reject_unknown_payer": false,
    "split_payment": null,
    "split_batch_id": null,
    "created_at": "2023-04-02T11:39:36.000Z",
    "updated_at": "2023-04-02T11:40:26.751Z",
    "pix_key": {
        "id": "01ca650b-a503-48f0-9c75-46d4866e5bf1",
        "key": "473a050d-69ed-42f9-9ef1-45657ac6e341",
        "key_type": "CHAVE_ALEATORIA"
    },
    "emv_payload": "00020101021226910014br.gov.bcb.pix2569api.developer.btgpactual.com/v1/p/v2/5ea96c5cc5a34d0b816e905950019d5f5204000053039865802BR5925SAFE WAY GESTAO DE RECURS6012sao paulo SP62070503***63043F1E",
    "image_base64": "iVBORw0KGgoAAAANSUhEU",
    "pix_received": {
        "id": "747ac8a8-230a-47c1-9909-cfc9430da5d4",
        "value": 20,
        "end2end_id": "E22896431202304021140rfKm8mIwtjm",
        "txid": "b7a6922117a11bc81da08940bc8a11b2",
        "integration_id": "1623756",
        "receipt_file_url": "https://api.url.com/xyz/abcd/woI9JGFcWIx6bcige3MqkZUdmAPGFBiJBlyTOrV8ktgWCArLipfjy23awbezowoy0iGb4jG8E6Li39srYtclYmu64667dc17186e",
        "pix_key": "473a050d-69ed-42f9-9ef1-45657ac6e341",
        "pix_description": null,
        "payer": {
            "name": "IZAURA BENDITA DA SILVA",
            "document": "***.002.004-**",
            "account_type": "CONTA_CORRENTE",
            "account": "62264500",
            "account_digit": "1",
            "agency": "0001",
            "bank": {
                "name": "Picpay servicos s.a.",
                "code": "380",
                "ispb": "22896431"
            }
        }
    }
}

No exemplo acima, podemos verificar que o devedor (payer) e o pagador (pix_received.payer) estão diferentes, por isso, é necessário realizar a devolução.

Importante

O sistema identifica a transação que necessita de devolução, e sempre tenta efetuar a primeira tentativa, porém algumas transações não são devolvidas.

Consultando tentativas de devolução:​

{
    "entries": [
        {
            "id": "7e7e3be9-09e2-44d0-902b-3b37f3b4d02b",
            "type": "CANCELLED_DEPOSIT_REFUND",
             ......atributos restantes
           },
        {
            "id": "a33ab1e8-9688-4570-96c3-2732d27f562f",
            "type": "CANCELLED_DEPOSIT_REFUND",
             ......atributos restantes
        },
        {
            "id": "952e59f4-239a-4dad-83c7-c0b338298bef",
            "type": "CANCELLED_DEPOSIT_REFUND",
             ......atributos restantes
            
        },
        {
            "id": "689f96ff-7385-48db-b8fd-eb96aa574baf",
            "value": -20,
            "end2end_id": "E22896431202304021140rfKm8mIwtjm",
            "return_id": "D27084098202304021140mmaQtA8aevY",
            "txid": null,
            "type": "CANCELLED_DEPOSIT_REFUND",
            "integration_id": null,
            "receipt_file_url": "https://api.transfeera.com/pub/receipt/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZXR1cm5faWQiOiJEMjcwODQwOTgyMDIzMDQwMjExNDBtbWFRdEE4YWV2WSIsInJlY2VpcHRfdHlwZSI6ImNhc2hpbl9yZWZ1bmQiLCJpYXQiOjE2ODI0MzEwODUsImV4cCI6MTY4NzYxNTA4NX0.XERDQcdByVpRTMVeKnc0QvIbBzjiZ1p_jAsrc0ldVqU",
            "payer": {
                "name": "IZAURA BENDITA DA SILVA",
                "document": "***.002.004-**",
                "account_type": "CONTA_CORRENTE",
                "account": "62264500",
                "account_digit": "1",
                "agency": "0001",
                "bank": {
                    "name": "Picpay servicos s.a.",
                    "code": "380",
                    "ispb": "22896431"
                }
            },
            "receiver": {
                "name": "SAFE WAY GESTAO DE RECURSOS FINANCEIROS LTDA",
                "document": "40033405000140",
                "account_type": "CONTA_PAGAMENTO",
                "account": "07200820",
                "account_digit": "0",
                "agency": "0001",
                "bank": {
                    "name": "Transfeera Pagamentos S.A.",
                    "code": null,
                    "ispb": "27084098"
                }
            },
            "error_code": null,
            "error_message": null
        }
    ],
    "metadata": {
        "pagination": {
            "itemsPerPage": 100,
            "totalItems": 11
        }
    }
}

Caso exista uma tentativa de devolução com status de sucesso, a transação foi devolvida.

Importante

Entretanto, no cenário em que não possua devolução e o número de tentativas exceda 10, a equipe deverá ser sinalizada para alterar o status da transação no sistema e abortar as devoluções.

Devolução​

Para fazer uma devolução, deve-se passar o atributo end2endid na url, como mostrado abaixo:

Link para requisição [POST]: https://api.transfeera.com/pix/cashin/{end2endid}/refund​

E enviar o atributo value, com o valor para devolver, no body: 

{
    "value": 1.00
}