> 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/pt-br/pagamento/criar-pagamento.md).

# Criar Pagamento

{% hint style="info" %}
DICA (TIP)

Inicie o pagamento em seu nome primeiro.
{% endhint %}

#### Endereço da interface (Interface address) <a href="#interface-address" id="interface-address"></a>

```
POST https://api.tokenpay.me/v1/payanother/payment
```

#### Interface parameters

| Nome           | Localização | Tipo   | Obrigatório | Descrição                                                                                                                                                                                                                     |
| -------------- | ----------- | ------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| app\_id        | body        | string | Sim         | ID do aplicativo, valor de exemplo: `8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd`                                                                                                                                                        |
| mch\_id        | body        | string | Sim         | ID do comerciante, valor de exemplo: `12345678`                                                                                                                                                                               |
| description    | body        | string | Não         | Descrição, valor de exemplo: `1234567890`                                                                                                                                                                                     |
| out\_trade\_no | body        | string | Não         | Número do pedido do comerciante (passe pelo menos um entre `out_trade_no` e `transaction_id`)                                                                                                                                 |
| amount         | body        | string | Sim         | Valor do pagamento                                                                                                                                                                                                            |
| chain          | body        | string | Sim         | Cadeia pública pertencente, valor de exemplo: `TRON`、`ETHEREUM`、`BSC`. [Ver cadeias públicas suportadas](/pt-br/moeda/informacoes-da-moeda.md)                                                                                |
| currency       | body        | string | Sim         | Moeda, valor de exemplo: `TRX`、`USDT`、`ETH`. [Ver moedas suportadas](/pt-br/moeda/informacoes-da-moeda.md)                                                                                                                    |
| to\_address    | body        | string | Sim         | Endereço de cobrança                                                                                                                                                                                                          |
| attach         | body        | string | Não         | Parâmetro personalizado. Ele retorna como está na API de consulta e nas notificações de pagamento e pode ser usado como um parâmetro personalizado. Na prática, este campo é retornado apenas quando o pagamento é concluído. |
| notify\_url    | body        | string | Não         | URL de retorno de chamada, valor de exemplo: `https://xxx/xxx`, [sugere-se o uso de https](/pt-br/descricao/informacoes-de-seguranca.md)                                                                                      |

{% hint style="info" %}
DICA (TIP)

O `app_id` pode ser obtido através do painel do comerciante [criando um aplicativo](https://ttpay.io/console/pages/app-list/pay-app).
{% endhint %}

#### Interface return

| Nome        | Tipo                                                                                    | Obrigatório | Descrição                                                     |
| ----------- | --------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------- |
| code        | integer                                                                                 | Sim         | [Código de status](/pt-br/codigo-de-erro/codigo-de-status.md) |
| msg         | string                                                                                  | Sim         | Descrição do status                                           |
| request\_id | string                                                                                  | Sim         |                                                               |
| data        | [PayoutTransactionDetail](/pt-br/descricao/estrutura-de-dados.md#detalhes-da-transacao) | Não         |                                                               |

#### Exemplo de retorno (Return example)

```json
{
    "code": 0,
    "msg": "ok",
    "request_id": "08250916-a677-4a36-a090-323807ac644c",
    "data": {
        "out_trade_no": "fb722ca8-ed7b-444b-9f58-0b5c8a7b52cb",
        "transaction_id": "e98b3029477f4bdcb971797a9d9e09ce",
        "trade_state": "SUCCESS",
        "description": "recharge",
        "block_no": 33215220,
        "create_time": 1673407302044,
        "block_time": 1673407329000,
        "expire_time": 1673407902044,
        "expire_second": 0,
        "pay_time": 1673407329000,
        "close_time": 0,
        "tx_id": "9fdf0ab5823e23225f93bcc644af30a6ab83b6583a8e29e359ee80219802a33a",
        "from_address": "TULRFYoFuEmUbxxxxxxxx8nQYFHJ88888",
        "contract_address": "",
        "to_address": "TQjxEW2Z3p9wjoxxxxxxxxgJUrWXBun91w",
        "amount": 15000000,
        "chain": "TRON",
        "decimals": 6,
        "attach": "anim dolore",
        "service_amount": 45000,
        "service_amount_currency": "USDT",
        "notify_url": "/console/callback/pay",
        "notify_num": 1,
        "notify_status": 2,
        "status": 2,
        "currency": {
            "type": "TRX",
            "chain": "TRON",
            "code": "TRON_TRX",
            "currency": "TRX",
            "name": "TRX",
            "sub_name": "TRON",
            "logo": "https://xxx/trx_busd.png",
            "contract_address": "",
            "decimal": 6,
        }
    }
}
```

#### Exemplo de código (Example code)

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

```sh
curl --location --request POST 'https://api.tokenpay.me/v1/payout/payment' \
--header 'Authorization: <Authorization>' \
--header 'User-Agent: tokenpay API (https://tokenpay.me)' \
--header 'Content-Type: application/json' \
--data-raw '<body data here>'
```

{% endtab %}

{% tab title="Go" %}

```go
package main

import (
   "fmt"
   "strings"
   "net/http"
   "io/ioutil"
)

func main() {

   url := "https://api.tokenpay.me/v1/payout/payment"
   method := "POST"

   payload := strings.NewReader(`<body data here>`)

   client := &http.Client {
   }
   req, err := http.NewRequest(method, url, payload)

   if err != nil {
      fmt.Println(err)
      return
   }
   req.Header.Add("Authorization", "<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
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
   CURLOPT_URL => 'https://api.tokenpay.me/v1/payout/payment',
   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 =>'<body data here>',
   CURLOPT_HTTPHEADER => array(
      'Authorization: <Authorization>',
      'User-Agent: tokenpay API (https://tokenpay.me)',
      'Content-Type: application/json'
   ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
```

<br>
{% endtab %}

{% tab title="Python" %}

```python
import http.client
import json

conn = http.client.HTTPSConnection("https://api.tokenpay.me")
payload = "<body data here>"
headers = {
   'Authorization': '<Authorization>',
   'User-Agent': 'tokenpay API (https://tokenpay.me)',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/payout/payment", 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, "<body data here>");
Request request = new Request.Builder()
   .url("https://api.tokenpay.me/v1/payout/payment")
   .method("POST", body)
   .addHeader("Authorization", "<Authorization>")
   .addHeader("User-Agent", "tokenpay API (https://tokenpay.me)")
   .addHeader("Content-Type", "application/json")
   .build();
Response response = client.newCall(request).execute();
```

{% endtab %}
{% endtabs %}