Tạo link thanh toán ECOM

POST 
/openapi/v1/ecom/payments/link

Tạo link thanh toán trực tuyến ECOM cho một đơn hàng của Merchant. API trả về đường dẫn payment_url để khách hàng tiến hành thanh toán qua Cổng thanh toán Digistore.

Payload trước khi mã hóa:

{
  "order_id": "ORD889922",
  "amount": 150000,
  "currency": "VND",
  "description": "Thanh toan don hang ORD889922",
  "return_url": "https://merchant.com/payment/return",
  "ipn_url": "https://merchant.com/api/ipn",
  "locale": "vi",
  "expires_in": 900,
  "customer": {
    "name": "Nguyen Van A",
    "email": "[email protected]",
    "phone": "0901234567"
  },
  "metadata": {
    "store_id": "STORE_01",
    "note": "Don hang VIP"
  }
}

Trường	Bắt buộc	Mô tả
order_id	✅	Mã đơn hàng duy nhất phía đối tác
amount	✅	Số tiền thanh toán (> 0)
currency	✕	Loại tiền tệ (Mặc định VND)
description	✕	Mô tả đơn hàng
return_url	✕	Đường dẫn chuyển hướng sau khi hoàn tất thanh toán
ipn_url	✕	Đường dẫn nhận thông báo kết quả IPN tự động
locale	✕	Ngôn ngữ giao diện thanh toán (Mặc định vi)
expires_in	✕	Thời hạn link tính bằng giây (Mặc định 900 giây)
customer	✕	Thông tin khách hàng (name, email, phone)
metadata	✕	Dữ liệu bổ sung dạng key-value của Merchant (store_id, note, ...)

Request

Responses

200

Tạo link thanh toán thành công