worldline

Documentation

Standalone refund

Also known as " Unreferenced refund " shall be used when it’s no longer possible to perform a referenced refund. Like payments, all refund transactions could be processed either with single message or dual message flow. For dual message flow, you must also capture the authorized refund.

Make a standalone refund

Submit a create refund request and specify the amount that you want to refund in amount object. Set captureImmediately to "true" for immediate capture of refund without a need for follow up capture refund request from your end.

Example standalone refund request

Below given example request(POST /processing/v1/100812/520002526/refunds) will refund an amount of 21 EUR to the card provided.

{
    "operationId": "03eb5a6c-908b-467a-a5ed-0cb3fc687b4f",
    "transactionTimestamp": "2024-10-18T09:27:37.014Z",
    "amount": {
        "amount": 2100,
        "currencyCode": "EUR",
        "numberOfDecimals": 2
    },
    "cardPaymentData": {
        "cardEntryMode": "ECOMMERCE",
        "captureImmediately": true,
        "brand": "VISA",
        "cardData": {
            "cardNumber": "4176669999000104",
            "expiryDate": "122031",
            "cardSecurityCode": "012"
        }
    },
    "references": {
        "merchantReference": "Your-Order-587aaf4a-406d-4781-a5c3-3054ff35eda0"
    }
}

Example standalone refund response

{
    "refundId": "pay:ch:etu:mZhOM2_ASrOq0hSPqt3zxA",
    "responseCode": "0",
    "responseCodeDescription": "Accepted or completed successfully",
    "responseCodeCategory": "APPROVED",
    "responder": "WORLDLINE",
    "authorizationCode": "000000",
    "totalAuthorizedAmount": {
        "amount": 2100,
        "currencyCode": "EUR",
        "numberOfDecimals": 2
    },
    "references": {},
    "status": "CONFIRMED",
    "operationId": "03eb5a6c-908b-467a-a5ed-0cb3fc687b4f"
}

Standalone refund could get declined for valid reason(s), in such situation you must be able to rectify the issue before re-attempting or look for alternatives to get the refund processed. Refer to response handling to know more about response properties.