Penciptaan pesanan

PETUA (TIP)

Selepas pesanan dibuat, antara muka akan mengembalikan pautan pembayaran, dan pengguna akan memasuki mesin juruwang melalui pautan untuk membayar. Jika pedagang telah menyediakan aplikasi label putih, kod bahagian hadapan juga perlu disambungkan ke JS-SDK. Lihat SDK

Alamat antara muka (Interface address)

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

Parameter antara muka (Interface parameters)

Nama

Lokasi

Jenis

Dikehendaki

Penerangan

app_id

header

string

ID Aplikasi, nilai contoh: 8e4b8c2e7cxxxxxxxx1a1cbd3d59e0bd

mch_id

body

string

ID Pedagang, nilai contoh: 12345678

description

body

string

Tidak

Penerangan pesanan, nilai contoh: recharge

out_trade_no

body

string

Nombor pesanan pedagang, pedagang menjana nombor pesanan uniknya sendiri

expire_second

body

integer

Masa tamat tempoh (saat), nilai contoh: 3600

amount

body

number

Jumlah pesanan, nilai contoh: 15000000

chain

body

string

Rantaian awam yang dimiliki, nilai contoh: TRON

currency

body

string

Mata wang, nilai contoh: TRX. Lihat mata wang yang disokong

to_address

body

string

Tidak

Dompet kutipan (Nota: dompet pembayaran diperlukan untuk aplikasi monitor order)

attach

body

string

Tidak

Parameter tersuai (seperti pengecam unik seperti ID pengguna) dikembalikan tanpa perubahan dalam API pertanyaan dan pemberitahuan pembayaran. Secara amali, medan ini hanya dikembalikan apabila status pembayaran selesai.

locale

body

string

Tidak

Bahasa: zh_cn Cina, en Inggeris. Menggunakan mesin juruwang akan memaparkan bahasa lalai berdasarkan tetapan ini.

notify_url

body

string

Tidak

URL Panggilan Balik, nilai contoh: https://xxx/xxx. Cadangkan menggunakan https

return_url

body

string

Tidak

Alamat pemulangan, apabila pembayaran selesai atau gagal, klik butang kembali pada alamat. Ia boleh menjadi pautan https atau laluan aplikasi.

order_type

body

string

Kaedah pembayaran, nilai contoh: platform_order kutipan platform

Contoh parameter (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"
}

PETUA (TIP)

app_id boleh didapati melalui pejabat belakang pedagang dengan mencipta aplikasi.

Pulangan antara muka (Interface return)

Nama

Jenis

Penerangan

code

integer

Kod status

msg

string

Penerangan status

request_id

string

ID Permintaan

data

object

Objek data

prepay_id

string

ID Prabayar

ID sesi transaksi prabayar. Ia digunakan untuk panggilan antara muka seterusnya, dan nilainya sah untuk tempoh parameter expire_second yang ditetapkan apabila pesanan dibuat, atau anda boleh mengakses payment_url secara terus untuk melengkapkan pembayaran.

payment_url

string

URL Mesin juruwang pembayaran

payment_url adalah untuk memaparkan halaman tengah mesin juruwang pembayaran, anda boleh melengkapkan pembayaran dengan melawati url ini. payment_url sah untuk tempoh parameter expire_second yang ditetapkan apabila pesanan dibuat.

Contoh pulangan (Return example)

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

Contoh kod (Example code)

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>'

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

$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;

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"))

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();

SebelumnyaPesanan

SeterusnyaPertanyaan pesanan

Terakhir dikemas kini 25 hari lalu