> For the complete documentation index, see [llms.txt](https://apidoc.tokenpay.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.tokenpay.me/order/order-closure.md).
# Order closure
{% hint style="info" %}
TIP
For users to manually cancel orders or merchants to cancel orders.
{% endhint %}
### Interface address
```
POST https://api.tokenpay.me/v1/transaction/close
```
### Interface parameters
| Name | location | Type | Required | Description |
| --------------- | -------- | ------ | -------- | ----------------------------------------------------------------- |
| app\_id | header | string | Yes | App ID, example value: `8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd` |
| mch\_id | body | string | Yes | Merchant ID, example value: `12345678` |
| transaction\_id | body | string | No | Platform order, example value: `2a1cfa6568xxxxxxxx3050957024c559` |
#### Parameters example
```json
{
"app_id": "8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd",
"mch_id": "12345678",
"transaction_id": "2a1cfa6568xxxxxxxx3050957024c559"
}
```
### Interface return
| Name | Type | Description | Description |
| ----------- | ------- | ----------------------------------------- | ----------- |
| code | integer | [Status code](/error-code/status-code.md) | none |
| msg | string | Status description | none |
| request\_id | string | Request ID | none |
### Return example
```json
{
"code": 0,
"msg": "success",
"request_id": "f23ade4a-e5ca-48f4-a4bb-59114ac360ba",
}
```
### Example code
{% tabs %}
{% tab title="Shell" %}
```sh
curl --location --request POST 'https://api.tokenpay.me/v1/transaction/close' \
--header 'Authorization: ' \
--header 'User-Agent: tokenpay API (https://tokenpay.me)' \
--header 'Content-Type: application/json' \
--data-raw ''
```
{% endtab %}
{% tab title="Go" %}
```go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.tokenpay.me/v1/transaction/close"
method := "POST"
payload := strings.NewReader(``)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Authorization", "")
req.Header.Add("User-Agent", "tokenpay API (https://tokenpay.me)")
req.Header.Add("Content-Type", "application/json")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
```
{% endtab %}
{% tab title="PHP" %}
```php
'https://api.tokenpay.me/v1/transaction/close',
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 =>'',
CURLOPT_HTTPHEADER => array(
'Authorization: ',
'User-Agent: tokenpay API (https://tokenpay.me)',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
{% endtab %}
{% tab title="Python" %}
```python
import http.client
import json
conn = http.client.HTTPSConnection("https://api.tokenpay.me")
payload = ""
headers = {
'Authorization': '',
'User-Agent': 'tokenpay API (https://tokenpay.me)',
'Content-Type': 'application/json'
}
conn.request("POST", "/v1/transaction/close", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
{% endtab %}
{% tab title="Java" %}
```java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://api.tokenpay.me/v1/transaction/close")
.method("POST", body)
.addHeader("Authorization", "")
.addHeader("User-Agent", "tokenpay API (https://tokenpay.me)")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
```
{% endtab %}
{% endtabs %}