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

# Get Order Customer Info

> Retrieve the customer (sender) information associated with an onramp order.

Retrieve the customer (sender) information associated with an onramp order. The response includes the masked bank account number, bank code, and name of the sender as provided by the payment provider during the fiat deposit callback.

This endpoint is **only meaningful for onramp orders** that have received a fiat deposit callback. If the provider does not return customer info, or if the callback has not yet arrived, the response indicates the reason via the `code` field.

## Authentication

<ParamField header="Partner-App-Key" type="string" required>
  Your partner app key.
</ParamField>

## Path Parameters

<ParamField path="order_id" type="string" required>
  The UUID of the order.
</ParamField>

## Response Codes

| `code` | Name           | Meaning                                                               |
| ------ | -------------- | --------------------------------------------------------------------- |
| `0`    | SUCCESS        | `customer_info` is populated.                                         |
| `2`    | NOT\_SUPPORTED | The payment provider for this order does not return customer info.    |
| `3`    | NOT\_AVAILABLE | The fiat deposit callback has not yet been received; try again later. |

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "success",
    "data": {
      "success": true,
      "code": 0,
      "error": "",
      "customer_info": {
        "customer_account": "1234****7890",
        "customer_bank_code": "970423",
        "customer_name": "NGUYEN VAN A"
      }
    }
  }
  ```

  ```json 200 Not Available theme={null}
  {
    "message": "success",
    "data": {
      "success": false,
      "code": 3,
      "error": "customer info not yet available",
      "customer_info": null
    }
  }
  ```

  ```json 200 Not Supported theme={null}
  {
    "message": "success",
    "data": {
      "success": false,
      "code": 2,
      "error": "provider does not return customer info",
      "customer_info": null
    }
  }
  ```
</ResponseExample>
