On This Page

{#jumplink-list}  
[Markdown](/docs/cybs/en-us/thunes/developer/all/so/thunes/thunes-mobilepay-intro/thunes-mobilepay-status-intro.md)  
Filter  
FILTER BY TAG

Check a Status {#concept}
=========================

This section describes how to retrieve the current status of a sale or refund. Send a check status request to know if a pending sale is settled, or to verify that a refund request is refunded. Use the check status request as often as necessary to obtain the information that you need.  
The check status request requires the request ID from the sale or refund response. The request ID is in the requestID response field.

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`

Required Fields for Checking a Status {#x-req-fields}
=====================================================

[apCheckStatusService_checkStatusRequestID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-check-status-service-check-status-req-id.md "")
:
Set to the request ID included in the sale or refund response.

[apCheckStatusService_run](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-check-status-service-run.md "")
:
Set to `true`.

[apPaymentType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/ap-payment-type.md "")
:
Set to `MOP`.

[merchantID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-id.md "")
:

[merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "")
:

Example: Checking a Status {#x-ex-rest}
=======================================

Request

```
<requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.211">
  <merchantID>nrphotography</merchantID>
  <merchantReferenceCode>Check-Status</merchantReferenceCode>
  <apPaymentType>MOP</apPaymentType>
  <apCheckStatusService run="true">
    <checkStatusRequestID>7520730687846156704605</checkStatusRequestID>
  </apCheckStatusService>
</requestMessage>
```

Response to a Successful Request

```
<replyMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.211">
  <merchantReferenceCode>Check-Status</merchantReferenceCode>
  <requestID>7520733091706238904606</requestID>
  <decision>ACCEPT</decision>
  <reasonCode>100</reasonCode>
  <requestToken>AxjnrwSTl7MjVFrrp6keANgZYjWmdqHRr1pdRknvzPgX7ZoDYZiiNDJpJl6MYZYX6Tl7Mayg6hXZtdAA7jiI</requestToken>
  <apCheckStatusReply>
    <reasonCode>100</reasonCode>
    <reconciliationID>XFZ3ZCQWVKT2</reconciliationID>
    <paymentStatus>settled</paymentStatus>
    <processorResponse>00004</processorResponse>
    <processorToken>384920815203</processorToken>
  </apCheckStatusReply>
</replyMessage>
```

Response Statuses for Checking a Status {#x-req-fields}
=======================================================

`Cybersource` responds to your check status request with one of these statuses in the field:

Check Status Responses for a Sale
:
* `ABANDONED`: The customer did not complete the payment using the redirect URL.
* `FAILED`: The service request failed. A failed request can be due to either MobilePay rejecting the transaction or a technical error.
* `FUNDED`: The settled amount is funded to the merchant bank account.
* `PENDING`: The service request is accepted but is not completed. Request the check status service to retrieve status updates.
* `SETTLED`: The sale request is settled for the requested amount.

Check Status Responses for a Refund
:
* `FAILED`: The service request failed. A failed request can be due to either MobilePay rejecting the transaction or a technical error.
* `REFUNDED`: The settled amount is successfully refunded.

RELATED TO THIS PAGE