Wallet

Wallet

This endpoint allows you to create a recurring Wallet payment in Vietnam.

After the recurring payment order is created successfully, Pagsmile returns a web_url. Redirect the user to the web_url to continue and complete the payment authorization.

Vietnam recurring Wallet payment currently supports Zalopay.

Vietnam recurring Wallet payment supports real-time payment processing.

Vietnam recurring Wallet payment supports refund.

POST https://gateway-test.pagsmile.com/trade/recurring

Request Body

Parameter	Type	Required	Constraints	Description
app_id	string	Required	Max length: 32	The merchant application ID assigned by Pagsmile.
timestamp	string	Required	Format: yyyy-MM-dd HH:mm:ss; max length: 19	Request timestamp.
method	string	Required	Fixed value: Wallet	Payment method.
channel	string	Required	Fixed value: Zalopay	Wallet channel.
order_amount	string	Required	Min: 1; max: 20,000,000	Recurring payment amount.
order_currency	string	Required	Fixed value: VND	Payment currency.
trial_amount	string	Required	Min: 1; max: 20,000,000	Trial payment amount.
trial_period	string	Required	Example: 1D	Trial period.
interval	string	Required	Example: 1D	Recurring payment interval.
quantity	integer	Required	Positive integer; example: 30	Number of recurring payment cycles.
trade_type	string	Required	Fixed value: WEB	Trade type.
out_trade_no	string	Required	Max length: 64	Merchant order number. Must be unique.
subject	string	Required	Max length: 128	Payment subject or order title.
content	string	Optional	Max length: 255	Payment content or order description.
notify_url	string	Required	Valid URL	The URL to receive payment notifications.
return_url	string	Required	Valid URL	The URL to redirect the user after payment.
buyer_id	string	Required	Max length: 64	Merchant-side user ID.

Request Sample

{
  "app_id": "166***280",
  "timestamp": "2021-08-04 18:50:42",
  "method": "Wallet",
  "channel": "Zalopay",
  "order_amount": "10",
  "order_currency": "VND",
  "trial_amount": "1000",
  "trial_period": "1D",
  "interval": "1D",
  "quantity": 30,
  "trade_type": "WEB",
  "out_trade_no": "out_trade_no_101***791",
  "subject": "trade pay test",
  "content": "trade pay test content",
  "notify_url": "http://merchant/callback/success",
  "return_url": "https://pagsmile.com/zh/",
  "buyer_id": "buyer123"
}

Response Sample

{
  "code": "10000",
  "msg": "Success",
  "out_trade_no": "out_trade_no_10***791",
  "trade_no": "2026***153",
  "web_url": "https://checkout.pagsmile.com?prepay_id=TVR*******1212sasd",
  "prepay_id": "TVRo***F52F1"
}

After receiving the web_url, redirect the user to the web_url to continue the payment authorization.