On This Page

Reverse an Authorized Payment

The authorization reversal service enables you to reverse the amount that was authorized. To reverse an authorization, you must have the authorization request ID, which is the

requestID

field value from the authorization response. To reverse a follow-on authorization, use the request ID from the follow-on authorization response.

Endpoints

Set the

apAuthReversalService_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

Response Status

The authorization reversal service responds with one of these statuses as the

apAuthReversalReply_status

field value:

PENDING

: The authorization reversal request is successful and is currently processing. Send periodic check status requests until you receive an updated status. For more information, see Check a Request Status.

FAILED

: The authorization reversal is not successful. Send a new request. A failed request can be due to either Klarna rejecting the transaction or a technical error.

The authorization reversal service also responds with a reason code as the

apAuthReversalreply_reasonCode

field value. For more information on reason codes, see the Reason Codes for the Simple Order API.

When you send a check status request for a pending authorization reversal, you can receive this status when the authorization reversal updates:

AUTH_REVERSED

: The authorization is successfully reversed.

Required Fields for Authorization Reversal

Include these required fields to reverse an authorization.

apAuthReversalService_authRequestID: Set to the request ID included in the authorization response. If you sent a follow-on authorization, use the request ID from the follow-on authorization response.
apAuthReversalService_run: Set to
true
.
apPaymentType: Set to
KLI
.
merchantID
merchantReferenceCode

XML Example: Authorization Reversal

Request

<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.213">
	<merchantID>test_merchant</merchantID>
	<merchantReferenceCode>ref-123456</merchantReferenceCode>
	<apPaymentType>KLI</apPaymentType>
	<apAuthReversalService run="true">
		<authRequestID>6958688084846249104011</authRequestID>
	</apAuthReversalService>
</requestMessage>

Response

<replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.213">
	<merchantReferenceCode>refnum-1234</merchantReferenceCode>
	<requestID>6958693435966100704008</requestID>
	<decision>ACCEPT</decision>
	<reasonCode>100</reasonCode>
	<requestToken>AxjnrwSTeTtFW0Xx4YsI/6IZYjWmjCbZrSIzaQojmjs01PSBX0GY0MmkmXoxZaH/pN5OzJYdUP50osAAFAIu</requestToken>
	<purchaseTotals>
		<currency>USD</currency>
	</purchaseTotals>
	<apAuthReversalReply>
		<reasonCode>100</reasonCode>
		<status>AUTH_REVERSED</status>
		<processorResponse>00007</processorResponse>
		<amount>10.00</amount>
		<dateTime>2023-09-28T02:49:04Z</dateTime>
		<paymentStatus>auth_reversed</paymentStatus>
		<responseCode>00007</responseCode>
		<reconciliationID>XFZ40MYVHF6H</reconciliationID>
	</apAuthReversalReply>
</replyMessage>