Estornar Cobrança no Cartão

Este endpoint é utilizado para realizar o estorno (reembolso) total ou parcial de uma transação específica que já tenha sido capturada e liquidada, estando atrelada a uma assinatura ou contrato recorrente. Ele permite devolver o valor pago diretamente para o cartão do cliente final.

Para realizar o estorno de uma transação, é necessário possuir um token válido e utilizar o endpoint Estornar Cobrança no Cartão.

Modelo de requisição:

curl --location --request PUT 'https://sandbox.openfinance.celcoin.dev/baas/v1/cash/transactions/{transactionId}/{typeId}/reverse' \
--header 'accept: application/json' \
--header 'Authorization: Bearer acess_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "valueToReverse": 1000
}'

📘
O campo valueToReverse é opcional. Caso não informado, será considerado o valor total da cobrança

Modelo de retorno:

{
    "Subscription": {
        "galaxPayId": 1,
        "myId": "sub-67f9567aa9d8d9.87867238",
        "mainPaymentMethodId": "creditcard",
        "value": 12999,
        "additionalInfo": "Mensalidade do plano Premium.",
        "status": "active",
        "Transactions": [
            {
                "galaxPayId": 1,
                "myId": "pay-67f95f4bdd2404.18166132",
                "value": 12999,
                "payday": "2025-04-11",
                "installment": 3,
                "statusDate": "2025-04-11 15:30:42",
                "datetimeLastSentToOperator": "2025-04-11 15:30:42",
                "status": "reversed",
                "statusDescription": "Estornada na Operadora de Cartão",
                "tid": "pay-67f95fd22382c1.40673689",
                "authorizationCode": "pay-67f95fd224d531.00132717",
                "PaymentMethodCreditCard": {
                    "qtdInstallments": 12,
                    "Card": {
                        "myId": "pay-67f95fd2260c18.50206926",
                        "galaxPayId": 1,
                        "number": "5451*********1515",
                        "createdAt": "2020-06-02 10:10:00",
                        "updatedAt": "2020-06-02 10:10:00",
                        "Brand": {
                            "id": "mastercard",
                            "name": "MasterCard"
                        },
                        "expiresAt": "2025-04"
                    }
                }
            }
        ]
    }
}

O campo valueToReverse é opcional. Caso não informado, será considerado o valor total da cobrança