Refund a Payment

A refund is linked to a capture or sale. Bancontact transaction support:
  • Refunds of payments that have a status of settled.
  • Partial refunds and multiple refunds.
  • Refunds for the original payment amount and the addition of 25 EUR. If the original payment amount was 45 EUR, you can refund up to 70 EUR.
The refund service request is a follow-on request that uses the request ID value returned in the sale service reply. The request ID value links the refund transaction to the original payment transaction.
Before refunding a payment and returning funds to the customer account, the payment status must be settled. You must request a refund within 180 days of the authorization.

Endpoints

Set the
apRefundService_run
 field to
true
, and send the request to one of these endpoints:
Production:
https://ics2ws.ic3.com/commerce/1.x/transactionProcessor
Test:
https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor

Required Fields for Refunding a Payment

apPaymentType
Set to
IDL
.
apRefundService_refundRequestID
Include the value of the
requestID
 field that was returned in the sale service reply.
apRefundService_run
Set to
true
.
merchantID
merchantReferenceCode
purchaseTotals_currency
Set to
EUR
.
purchaseTotals_grandTotalAmount

Required Fields for
Cybersource
 Settlement Services Accounts

If you have a
Cybersource
 Settlement Services Account, include these required fields in addition to the required fields listed above.
billTo_city
billTo_country
billTo_firstName
billTo_lastName
billTo_street1

Example: Refunding a Payment

Light Dark
Refund Service Request
123456789101112
<="urn:schemas-cybersource-com:transaction-data-1.126">
   <merchantID>mid43210</merchantID>
   <merchantReferenceCode>refnum1234</merchantReferenceCode>
   <purchaseTotals>
      <currency>EUR</currency>
      <grandTotalAmount>20.00</grandTotalAmount>
   </purchaseTotals>
   <apPaymentType>IDL</apPaymentType>
   <apRefundService run="true">
      <refundRequestID>4703329437356002101200</refundRequestID>
   </apRefundService>
</>
Response to a Successful Refund Service Request
1234567891011121314151617181920
<:c="urn:schemas-cybersource-com:transaction-data-1.126">
   <merchantReferenceCode>refnum1234</merchantReferenceCode>
   <requestID>8484832012000483918274</requestID>
   <decision>ACCEPT</decision>
   <reasonCode>100</reasonCode>
   <purchaseTotals>
      <currency>EUR</currency>
   </purchaseTotals>
   <apRefundReply>
      <reasonCode>100</reasonCode>
      <status>refunded</status>
      <processorResponse>0000006</processorResponse>   
      <amount>20.00</amount>
      <dateTime>2020-01-11T15:43:01Z</dateTime>
      <reconciliationID>01950351</reconciliationID>
      <processorTransactionID>903344</processorTransactionID>
      <paymentStatus>completed</paymentStatus>
      <responseCode>00006</responseCode>
   </apRefundReply>
</>