Create ECOM Payment Link

POST 
/openapi/v1/ecom/payments/link

Create an online ECOM payment link for a Merchant order. The API returns a payment_url for the customer to complete payment through the Digistore payment gateway.

Payload before encryption:

{
  "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"
  }
}

Field	Required	Description
order_id	✅	Unique partner-side order code
amount	✅	Payment amount (> 0)
currency	✕	Currency (default VND)
description	✕	Order description
return_url	✕	URL the customer is redirected to after payment completes
ipn_url	✕	URL to receive the automatic IPN result notification
locale	✕	Checkout UI language (default vi)
expires_in	✕	Link lifetime in seconds (default 900)
customer	✕	Customer info (name, email, phone)
metadata	✕	Merchant key-value extra data (store_id, note, ...)

Request

Responses

200

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