> ## Documentation Index
> Fetch the complete documentation index at: https://developer.gcashier.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Transfer

> Query the status and details of an international transfer by merchant order number.

```
POST https://{baseUrl}/api/sp2305
```

### Request Parameters

<ParamField body="merOrderNo" type="string" required>
  Your merchant order number for the transfer to query.
</ParamField>

### Response Body

<ResponseField name="merOrderNo" type="string">
  Echo of your merchant order number. Unique.
</ResponseField>

<ResponseField name="senderAmount" type="object">
  Sender amount and currency information.

  <Expandable title="senderAmount fields">
    <ResponseField name="currency" type="string">
      Sender's currency code (ISO 4217).
    </ResponseField>

    <ResponseField name="amount" type="string">
      Sender's amount. Two decimal places, format: `999999.99`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="receiverAmount" type="object">
  Receiver amount, currency, and bank country information.

  <Expandable title="receiverAmount fields">
    <ResponseField name="currency" type="string">
      Receiver's currency code (ISO 4217).
    </ResponseField>

    <ResponseField name="amount" type="string">
      Receiver's amount. Two decimal places, format: `999999.99`.
    </ResponseField>

    <ResponseField name="bankCountry" type="string">
      ISO 3166-1 alpha-2 country code of the receiver's bank.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="feeObject" type="object">
  Fee information. Fields are populated when the transfer succeeds.

  <Expandable title="feeObject fields">
    <ResponseField name="feeCurrency" type="string">
      Fee currency. Present when the transfer succeeds.
    </ResponseField>

    <ResponseField name="feeAmt" type="string">
      Fee amount. Present when the transfer succeeds.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="infoObject" type="object">
  Transfer status and reference information.

  <Expandable title="infoObject fields">
    <ResponseField name="bizFlow" type="string">
      System business flow number. Consistent with the value returned by sp1306. Retain this for reconciliation.
    </ResponseField>

    <ResponseField name="senderId" type="string">
      Sender's registered ID. Present once the transfer is successfully confirmed.
    </ResponseField>

    <ResponseField name="receiverId" type="string">
      Receiver's registered ID. Present once the transfer is successfully confirmed.
    </ResponseField>

    <ResponseField name="settlementNetwork" type="string">
      Settlement network used: `LOCAL` or `SWIFT`.
    </ResponseField>

    <ResponseField name="rate" type="string">
      Exchange rate applied to this transfer.
    </ResponseField>

    <ResponseField name="status" type="string">
      Current order status:

      * `PROCESS` — Processing
      * `SUCC` — Successful
      * `FAIL` — Failed
    </ResponseField>

    <ResponseField name="finishTimestamp" type="number">
      Completion timestamp (Unix milliseconds). Only present when the transfer reaches a terminal state (`SUCC` or `FAIL`).
    </ResponseField>

    <ResponseField name="code" type="string">
      Transaction response code.
    </ResponseField>

    <ResponseField name="message" type="string">
      Transaction response message.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "merOrderNo": "335621309488900"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "merOrderNo": "335621309488900",
    "senderAmount": {
      "currency": "CNY",
      "amount": "712.50"
    },
    "receiverAmount": {
      "currency": "USD",
      "amount": "100.00",
      "bankCountry": "US"
    },
    "feeObject": {
      "feeCurrency": "CNY",
      "feeAmt": "15.00"
    },
    "infoObject": {
      "bizFlow": "21875022415083500099",
      "senderId": "a1b2c3d4e5f6",
      "receiverId": "f6e5d4c3b2a1",
      "settlementNetwork": "SWIFT",
      "rate": "7.1250",
      "status": "SUCC",
      "finishTimestamp": 1739500557000,
      "code": "S00000",
      "message": "Success"
    }
  }
  ```
</ResponseExample>
