Generate payment Deep Link

Generates a payment link (Deep Link) that redirects the user to the Tingee payment page.

Usage

Node.js

const result = await client.deepLink.generate({
  amount: 500000,
  orderId: 'ORDER_001',
  description: 'Thanh toan don hang',
  callbackUrl: 'https://your-site.com/callback',
});

Java

var req = new OpenApiGenerateDeepLinkDto();
req.setAmount(500000);
req.setOrderId("ORDER_001");
req.setDescription("Thanh toan don hang");
req.setCallbackUrl("https://your-site.com/callback");

var result = client.deepLink.generate(req);

C#

var result = await client.DeepLink.GenerateAsync(new OpenApiGenerateDeepLinkDto
{
    Amount = 500000,
    OrderId = "ORDER_001",
    Description = "Thanh toan don hang",
    CallbackUrl = "https://your-site.com/callback",
});

PHP

$result = $client->deepLink->generate(
    amount: 500000,
    orderId: 'ORDER_001',
    description: 'Thanh toan don hang',
    callbackUrl: 'https://your-site.com/callback',
);

Parameters

Field	Type	Required	Description
amount	number	✓	Payment amount
orderId	string	✕	Order ID
description	string	✕	Payment description
callbackUrl	string	✕	Callback URL after payment
merchantId	number	✕	Merchant ID (required when calling via Master Merchant)

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "deepLink": "https://tingee.vn/pay?token=abc123..."
  }
}

Field	Type	Description
data.deepLink	string	Payment Deep Link URL