# Check Orders

You can make a "check-orders" request to check the payment status of multiple orders.

If there is a list of orders and from these one or more are not found, this API call will not return data for the order\_ids that were not found

{% tabs %}
{% tab title="cURL" %}

```
curl --location --request POST 'https://sandbox.fcfpay.com/api/v2/check-orders' \
--header 'Authorization: Bearer YOUR_SANDBOX_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_ids": ["Test123","3x101","Test12"]
}'
```

{% endtab %}

{% tab title="JavaScript" %}

```
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer \"YOUR_SANDBOX_API_KEY\"");
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "order_ids": [
    "Test123",
    "3x101",
    "Test12"
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://sandbox.fcfpay.com/api/v2/check-orders", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

{% endtab %}

{% tab title="Node.js" %}

```
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://sandbox.fcfpay.com/api/v2/check-orders',
  'headers': {
    'Authorization': 'Bearer "YOUR_SANDBOX_API_KEY"',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "order_ids": [
      "Test123",
      "3x101",
      "Test12"
    ]
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

```

{% endtab %}

{% tab title="PHP" %}

```
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://sandbox.fcfpay.com/api/v2/check-orders',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "order_ids": ["Test123","3x101","Test12"]
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer "YOUR_SANDBOX_API_KEY"',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

```

{% endtab %}

{% tab title="Python" %}

```
import requests
import json

url = "https://sandbox.fcfpay.com/api/v2/check-orders"

payload = json.dumps({
  "order_ids": [
    "Test123",
    "3x101",
    "Test12"
  ]
})
headers = {
  'Authorization': 'Bearer "YOUR_SANDBOX_API_KEY"',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

```

{% endtab %}
{% endtabs %}

## Check Order

<mark style="color:green;">`POST`</mark> `https://merchant.fcfpay.com/api/v2/check-order`

#### Query Parameters

| Name                                         | Type  | Description                     |
| -------------------------------------------- | ----- | ------------------------------- |
| order\_ids<mark style="color:red;">\*</mark> | array | The Order IDs you want to check |

{% tabs %}
{% tab title="200: OK Call successful" %}

```javascript
{
    "success": true,
    "data": {
        "Test123": {
            "order_id": "Test123",
            "user_id": "1",
            "order_amount": 0,
            "total_fiat_amount": "54.75",
            "fiat_currency": "EUR",
            "txs": [
                {
                    "deposited": true,
                    "txid": "0x278859d371bd6084963db80ba066fc891fe006047b0dc5c4929efff35918052c",
                    "confirm_blocks": 24,
                    "status": "deposited",
                    "amount_usd": "33.89",
                    "fiat_amount": "33.10",
                    "fiat_currency": "EUR",
                    "amount": "150000000000000000",
                    "currency": "BSC",
                    "fees": "210000000000000",
                    "decimal": 18,
                    "fee_decimal": 18,
                    "date": "Jul 05 2022 03:02:35"
                },
                {
                    "deposited": true,
                    "txid": "0x2d54bfbfaf5fcd36a3ebb2400809b08d72defce9f121b3d30cb0bad57d23377c",
                    "confirm_blocks": 22,
                    "status": "deposited",
                    "amount_usd": "22.47",
                    "fiat_amount": "21.94",
                    "fiat_currency": "EUR",
                    "amount": "100000000000000000",
                    "currency": "BSC",
                    "fees": "210000000000000",
                    "decimal": 18,
                    "fee_decimal": 18,
                    "date": "Jul 05 2022 03:02:35"
                }
            ]
        },
        "3x101": {
            "order_id": "3x101",
            "user_id": "1",
            "order_amount": 0,
            "total_fiat_amount": 0,
            "fiat_currency": "USD",
            "txs": []
        }
    },
    "message": "Successfully fetched."
2
```

{% endtab %}

{% tab title="404: Not Found Order id not found" %}

```javascript
{
    "success": false,
    "message": "",
    "data": "Something went wrong!"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-docs.fcfpay.com/reference/api-requests-v2/check-orders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.