Đến nội dung

Tạo đơn GMPay ​

POSThttps://pay.example.com/payments/gmpay/v1/order/create-transaction

Ví dụ yêu cầu ↓

Ký yêu cầu trên máy chủ rồi mở payment_url cho người mua. Gửi cả token và network hoặc bỏ cả hai để người mua tự chọn.

Tham số ​

TrườngKiểuBắt buộcMô tả
pidChuỗiCóTrước đây, Merchant PID đã sử dụng để tìm kiếm khóa ký.
order_idChuỗiCóMã đơn hàng độc đáo của nhà bán hàng, tối đa 32 ký tự.
currencyChuỗiCóLoại tiền pháp định, chẳng hạn usd hoặc cny.
tokenChuỗiCó điều kiệnTiếp nhận tài sản. Kết hợp với mạng hoặc bỏ cả hai.
networkChuỗiCó điều kiệnID mạng từ cấu hình công khai, ví dụ: binance.
amountSốCóSố fiat lớn hơn 0,01.
notify_urlChuỗiCóURL hồi báo thành công không đồng bộ.
redirect_urlChuỗiKhôngTrang web được trả về bởi trình duyệt.
nameChuỗiKhôngTên sản phẩm hoặc đơn hàng.
payment_typeChuỗiKhôngMặc định sử dụng GMPay. EPay (không phân biệt chữ hoa/chữ thường) chọn định dạng callback của EPay và yêu cầu một PID số. Bao gồm bất kỳ giá trị nào không rỗng trong chữ ký.
signatureChuỗiCóChữ ký HMAC-SHA256 với độ dài 64 ký tự (thường là chữ).

Chữ ký mẫu dùng khóa minh họa epusdt_secret_key. Tính lại trên máy chủ khi thay đổi tham số hoặc khóa.

Tài liệu liên quan ​

Phản hồi

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data object

    Dữ liệu trả về; null khi có lỗi.

    • trade_id string
    • order_id string
    • status integer
    • expiration_time integer
    • payment_url string
  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

application/json
Trường phản hồi
  • status_code integer

    Mã kết quả nghiệp vụ.

  • message string

    Thông báo kết quả.

  • data null

    Dữ liệu trả về; null khi có lỗi.

  • request_id string

    Mã yêu cầu dùng để tra cứu nhật ký.

error-codes.json ↓