Skip to main content

Payment Link

Payment Link are a simple way for customers to pay you when you sell online. Create a single link that you can share with everyone.

Workflow​

The Simply Payment Link does not include product details and only displays the payment amount.

  • reference_number: This is usually your unique order ID, which is used to associate the Wonder Payment Link Order Number with your own order system.
  • charge_fee: charge_fee is the final amount you charge to the user, and the currency of the received payment will be determined by the merchant's configuration.
{
    "order" : {
        "reference_number" : "<your side unique number>",
        "charge_fee" : "21.00",
        "note" : "test",
        "callback_url" : "<send webhook to your server>",
        "redirect_url" : "<redirect back to your website after payment completed.>",
         }
     }

Add product item details​

Include detailed Line Item information in the order result. These details will also be displayed on the Payment Link page for payers to review. line items size up to 100.

  • purchasable_type: Fixed as Listing.
  • price: The item price for single quantity.
  • quantity: How many quantity delivery to customer.
  • total: price * quantity
  • label: A short text description or product name.
{
    "order": {
        ...
        "line_items": [
                {
                    "purchasable_type": "Listing",
                    "price": "10.00",
                    "quantity": "2",
                    "total": "20.00",
                    "label": "<Product Name>"
                },
                ...
            ]
         }
    }

You can create a Payment Link for a specific Customer. This is usually configured for long-term regular customers. The customer can directly save a credit card as a Payment Token on the Payment Link page, and then select and use it directly without re-entering the card information.

{
     "customer_uuid" : "<customer uuid from create customer API>",
     "order" : {
        ...
     }
}

For security considerations, a Payment Link should not remain valid indefinitely. We provide two methods to control the lifecycle of a Payment Link.

  • Due Date: A date as Y-m-d format, the order will be voided after the date.
  • Timeout: The payment link will be expired after the timeout configure, start timer from first open the Payment Link.
{
  "order" : {
    ...
    "due_date" : "2026-01-01",
    "timeout" : {
        "timer" : 60, //60 seconds
        "url" : "<Your website URL>", // redirect to your website after timeout.
    }
  }
}

Pre Authorization​

Beyond the conventional one-time payment scenarios, payment links also support pre-authorization. After customers complete pre-authorization via the Payment Link, you can finalize the transaction through the Capture API.

Not all payment methods support pre-authorization transactions, and those that do not will not be displayed.

    {
        "order" : {
            ...
            "is_only_pre_auth" : true,
        }
    }

No coding mode​

Generate a Invoice Link without any coding.