Reversals

An authorization reversal releases the hold that an authorization placed on a customer’s payment method funds.

cUrl

POST /v1/payments/:id/reversal

curl –X POST 'https://api.firstoken.co/v1/payments/:id/reversal' \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR API KEY' \
--data '{
    "transaction_info": {
        "type": "authorization_reversal",
        "reference_code": "123456789"
    },
    "reversal_info": {
        "amount_details": {
            "total_amount": 1000
        }
    },
    "device_info": {
        "ip_address": "12.7.8.120"
    }
}'

Params of the request

Attributes of the response

Example of the JSON response

{
    "status": "success",
    "message": "Authorization reversal successfull",
    "data": {
        "transaction_info": {
            "type": "authorization_reversal_response",
            "reference_code": "123456789",
            "transaction_id": "0001708979971435543349",
            "request_id": "7089799728616517004951",
            "status": "Reversed",
            "created_at": "2024-02-26T20:39:33Z"
        }
    }
}