> ## 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.

# Payout Quote

> Submit a transfer request to obtain a real-time exchange rate quote. The response includes a `bizFlow` reference and `expireTime`. You must call sp1307 to confirm the transfer before the quote expires.

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

### Request Parameters

<ParamField body="merOrderNo" type="string" required>
  Your unique merchant order number. Max 32 characters.
</ParamField>

<ParamField body="infoObject" type="object" required>
  Transfer routing information.

  <Expandable title="infoObject fields">
    <ParamField body="settlementNetwork" type="string" required>
      Settlement network. `LOCAL` for local payment rails, `SWIFT` for international wire.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="senderAmount" type="object" required>
  Sender's currency and amount.

  <Expandable title="senderAmount fields">
    <ParamField body="currency" type="string" required>
      ISO 4217 currency code for the sender (e.g. `CNY`). See the currency dictionary.
    </ParamField>

    <ParamField body="amount" type="string">
      Amount the sender will pay. Mutually exclusive with `receiverAmount.amount` — provide one or the other, not both. Two decimal places, format: `999999.99`.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="receiverAmount" type="object" required>
  Receiver's currency, amount, and bank country.

  <Expandable title="receiverAmount fields">
    <ParamField body="currency" type="string" required>
      ISO 4217 currency code for the receiver (e.g. `USD`). See the currency dictionary.
    </ParamField>

    <ParamField body="amount" type="string">
      Amount the receiver should receive. Mutually exclusive with `senderAmount.amount` — provide one or the other, not both. Two decimal places, format: `999999.99`.
    </ParamField>

    <ParamField body="bankCountry" type="string" required>
      ISO 3166-1 alpha-2 country code of the receiver's bank. See the country dictionary.
    </ParamField>
  </Expandable>
</ParamField>

### Response Body

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

<ResponseField name="senderAmount" type="object">
  Confirmed sender amount and currency.

  <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">
  Confirmed receiver amount, currency, and bank country.

  <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="infoObject" type="object">
  Quote details and reference information.

  <Expandable title="infoObject fields">
    <ResponseField name="bizFlow" type="string">
      System business flow number. Pass this value to sp1307 when confirming the transfer.
    </ResponseField>

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

    <ResponseField name="rate" type="string">
      Locked exchange rate for this quote.
    </ResponseField>

    <ResponseField name="expireTime" type="string">
      Rate validity period in seconds. You must call sp1307 to confirm within this window, otherwise the quote expires and a new request is required.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "merOrderNo": "335621309488900",
    "infoObject": {
      "settlementNetwork": "SWIFT"
    },
    "senderAmount": {
      "currency": "CNY",
      "amount": "712.50"
    },
    "receiverAmount": {
      "currency": "USD",
      "bankCountry": "US"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "merOrderNo": "335621309488900",
    "senderAmount": {
      "currency": "CNY",
      "amount": "712.50"
    },
    "receiverAmount": {
      "currency": "USD",
      "amount": "100.00",
      "bankCountry": "US"
    },
    "infoObject": {
      "bizFlow": "21875022415083500099",
      "settlementNetwork": "SWIFT",
      "rate": "7.1250",
      "expireTime": "300"
    }
  }
  ```
</ResponseExample>