Bulk Refund or Void Transactions

You can use the bulk-refund API to refund multiple transactions to a customer in a single request. The refunds are based on the amount you provide. You can provide a partial or complete refund.

Velocity exposes an API to cancel an authorized transaction or refund a captured transaction based on the status of the transaction. The Amount field can take values equal to or less than the captured or authorized amount. Amount is a mandatory field.

Path NamePath Details
End Point[Velocity URL]/mpoint/bulk-refund
Format/Content Typetext/xml
AuthenticationHTTP basic access authentication

16.1 Request

The following is an example of a Refund Transaction request:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <refund client-id="[integer]" account = "[integer]">
        <transaction id="5768217" order-no="UID346">
            <amount country-id="200">158726</amount>
        </transaction>
    </refund>
    <refund client-id="[integer]" account = "[integer]">
        <transaction id="5768212" order-no="JZC273">
            <amount country-id="200">251100</amount>
        </transaction>
    </refund>
</root>

16.2 Response

The following is an example of a Refund Transaction response:

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <transactions client-id="[integer]">
        <transaction id="5768217" order-no="UID346">
            <status code="1000"> [message] <status/>
        </transaction>
    </transactions>
    <transactions client-id="[integer]">
        <transaction id="5768212" order-no="JZC273">
            <status code="1000"> [message] <status/>
        </transaction>
    </transactions>
</root>

OR

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <status code="9400">
        <!--For Exceptions-->
        <exception type="http">
            <code>400</code>
        </exception>
    </status>
</root>

Note: If the status code is 1000, the refund is successful. Other rest response codes indicate a failure. Refer to Refund Payment codes for details.