Check a Request Status

Request the check status service when the authorization response status is
PENDING
. A pending status occurs when Klarna reviews an authorization.
Cybersource
recommends that you request the check status service hourly until the payment status changes.

Endpoints

Set the
apCheckStatusService_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 Statuses

The check status service responds with one of these statuses in the
apCheckStatusReply_status
field value:
Session
  • ABANDONED
    : The customer did not complete the payment using the redirect URL or widget.
  • COMPLETED
    : The customer completed the checkout process. You can now authorize the funds.
Authorization
  • AUTHORIZED
    : The customer's funds are authorized. You can now capture the authorized amount.
  • FAILED
    : The authorization request is not successful. Send a new authorization request. A failed request can be due to either Klarna rejecting the transaction or a technical error.
  • PENDING
    : The authorization request is successful and is still processing. Request the check status service again to retrieve status updates.
Authorization Reversal
  • AUTH_REVERSED
    : The authorization is successfully reversed.
  • 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.
  • PENDING
    : The authorization reversal request is accepted but is not completed. Request the check status service again to retrieve status updates.
Capture
  • CHARGEBACK
    : The customer submitted a payment dispute for the purchase, and Klarna reviewed and approved a chargeback to the customer. For more information about chargebacks, see Klarna Chargebacks.
  • FAILED
    : The capture request is not successful. Send a new capture request. A failed request can be due to either Klarna rejecting the transaction or a technical error.
  • PENDING
    : The capture request is accepted but is not completed. Request the check status service again to retrieve status updates.
  • SETTLED
    : The capture request is settled for the requested amount.
Refund
  • FAILED
    : The refund request is not successful. Send a new refund request. A failed request can be due to either Klarna rejecting the transaction or a technical error.
  • PENDING
    : The refund request is successful and is currently processing. Request the check status service again to retrieve status updates.
  • REFUNDED
    : The captured payment is successfully refunded.

Required Fields for Check Status

Set to the request ID included in the service response you are checking.
Set to
true
.
Set to
KLI
.

XML Example: Check Status

Light Dark
Request
12345678
<="urn:schemas-cybersource-com:transaction-data-1.213"> <merchantID>test_merchant</merchantID> <merchantReferenceCode>refnum-1234</merchantReferenceCode> <apPaymentType>KLI</apPaymentType> <apCheckStatusService run="true"> <checkStatusRequestID>6957582387066840103011</checkStatusRequestID> </apCheckStatusService> </>
Response
123456789101112
<:c="urn:schemas-cybersource-com:transaction-data-1.213"> <merchantReferenceCode>refnum-1234</merchantReferenceCode> <requestID>6957587006586637103010</requestID> <decision>ACCEPT</decision> <reasonCode>100</reasonCode> <requestToken>AxjnrwSTeSvqh51d5a+i/6IZYjWmjCbZrR6FeUojmjMjRvSB3i0ZiwyaSZejFlof+k3kr2h4vmV04YwAnSiT</requestToken> <apCheckStatusReply> <reasonCode>100</reasonCode> <reconciliationID>XFZ40MYVGPWJ</reconciliationID> <paymentStatus>refunded</paymentStatus> </apCheckStatusReply> </>