Auftragserstellung

TIPP (TIP)

Nachdem die Bestellung erstellt wurde, gibt die Schnittstelle den Zahlungslink zurück. Der Benutzer ruft über den Link die Kasse auf, um zu bezahlen. Wenn der Händler eine White-Label-Anwendung eingerichtet hat, muss auch der Frontend-Code mit dem JS-SDK verbunden werden. SDK anzeigen

Schnittstellenadresse (Interface address)

POST https://api.tokenpay.me/v1/transaction/prepayment

Schnittstellenparameter (Interface parameters)

Name	Standort	Typ	Erforderlich	Beschreibung
app_id	header	string	Ja	Anwendungs-ID, Beispielwert: 8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd
mch_id	body	string	Ja	Händler-ID, Beispielwert: 12345678
description	body	string	Nein	Bestellbeschreibung, Beispielwert: recharge
out_trade_no	body	string	Ja	Händler-Bestellnummer, der Händler generiert seine eigene eindeutige Bestellnummer
expire_second	body	integer	Ja	Ablaufzeit (Sekunden), Beispielwert: 3600
amount	body	number	Ja	Bestellbetrag, Beispielwert: 15000000
chain	body	string	Ja	Zugehörige öffentliche Blockchain, Beispielwert: TRON
currency	body	string	Ja	Währung, Beispielwert: TRX. Unterstützte Währungen anzeigen
to_address	body	string	Nein	Inkasso-Wallet (Hinweis: Für die Anwendung monitor order ist ein Inkasso-Wallet erforderlich)
attach	body	string	Nein	Benutzerdefinierte Parameter (wie eindeutige Kennungen wie Benutzer-IDs) werden in Abfrage-APIs und Zahlungsbenachrichtigungen unverändert zurückgegeben. In der Praxis wird dieses Feld nur zurückgegeben, wenn der Zahlungsstatus abgeschlossen ist.
locale	body	string	Nein	Sprache: zh_cn Chinesisch, en Englisch. Die Verwendung der Kasse zeigt basierend auf dieser Einstellung die Standardsprache an.
notify_url	body	string	Nein	Callback-URL, Beispielwert: https://xxx/xxx. Verwendung von https wird empfohlen
return_url	body	string	Nein	Rücksprungadresse: Wenn die Zahlung abgeschlossen ist oder fehlschlägt, klicken Sie auf die Schaltfläche „Zurück“ bei der Adresse. Es kann ein https-Link oder die Route der App sein.
order_type	body	string	Ja	Zahlungsmethode, Beispielwert: platform_order Plattform-Inkasso

Parameterbeispiel (Parameters example)

{
  "app_id": "d549a3ac0e4641f998c6675fc539ba21",
  "mch_id": "12345678",
  "description": "recharge",
  "out_trade_no": "fb72xxxx-xxxx-xxxx-xxxx-xxxx8a7b52cb",
  "expire_second": 600,
  "amount": 9,
  "chain": "TRON",
  "currency": "USDT",
  "to_address": "TQjxEW2Z3p9wjoxxxxxxxxgJUrWXBun91w",
  "attach": "anim dolore",
  "locale": "zh_cn",
  "notify_url": "https://xxx/xxx",
  "return_url": "https://xxxx/xxx?id=xxxx",
  "order_type": "platform_order"
}

TIPP (TIP)

app_id kann über das Händler-Backend durch die Erstellung einer Anwendung bezogen werden.

Schnittstellenrückgabe (Interface return)

Name	Typ	Beschreibung	Beschreibung
code	integer	Statuscode
msg	string	Statusbeschreibung
request_id	string	Anfrage-ID
data	object	Datenobjekt
prepay_id	string	Vorauszahlungs-ID	Vorauszahlungs-Transaktions-Sitzungs-ID. Wird für nachfolgende Schnittstellenaufrufe verwendet, und der Wert ist für den bei der Auftragserstellung festgelegten Parameter expire_second gültig. Alternativ können Sie direkt auf die payment_url zugreifen, um die Zahlung abzuschließen.
payment_url	string	Zahlungskassen-URL	payment_url dient dazu, die Zwischenseite der Zahlungskasse aufzurufen. Sie können die Zahlung abschließen, indem Sie diese URL besuchen. payment_url ist für den bei der Auftragserstellung festgelegten Parameter expire_second gültig.

Rückgabebeispiel (Return example)

{
    "code": 0,
    "msg": "ok",
    "request_id": "9b9e08ab-48e5-4efa-83e7-97e5e3fe3d0c",
    "data": {
        "prepay_id": "15809074c5bbc36bce27exxxxxxxxxxxxxxxxxxxxa4ca0a281d7e1260624a1c2",
        "payment_url": "/pay/order?prepay_id=15809074c5bbc36bce27exxxxxxxxxxxxxxxxxxxxa4ca0a281d7e1260624a1c2"
    }
}

Code-Beispiel (Example code)

Shell

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

Go

package main

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

func main() {

   url := "https://api.tokenpay.me/v1/transaction/prepayment"
   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))
}

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
   CURLOPT_URL => 'https://api.tokenpay.me/v1/transaction/prepayment',
   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;

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/transaction/prepayment", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

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/transaction/prepayment")
   .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();