💸 Payment Link

The Payment Link resource makes it effortless to collect payments securely using Pandascrow's escrow infrastructure, with or without a website.

Payment Links create a preconfigured, shareable URL that anyone can use to send funds into an escrow account. This is perfect for freelancers, consultants, agencies, or platforms that need a quick way to request payment without needing to build complex integrations.

🔗 How It Works

You create a Payment Link with details like title, amount, currency, and description.
We generate a unique link (e.g., https://app.pandascrow.io/i/pandascrow-merch)
Share the link via email, chat, social media, or your website.
When someone pays, the funds are held securely in escrow until release conditions are met.

💼 Use Cases

Merchants creating branded payment links for limited-edition product drops
Freelancers requesting 50% upfront deposits or full project payments
Consultants or agencies sending payment links after discovery calls
Social sellers collecting funds before delivery
SaaS platforms generating recurring subscription links for new customers
Small businesses integrating trust payments without complex API development

✨ Features

One-time or recurring: Support for both onetime and recurring payment types
Custom link slugs: Branded URLs like pay.yourdomain.com/your-custom-slug
Escrow-backed: Funds are not released until conditions are met, reducing fraud
Phone number collection: Optionally require payer phone number for verification
Custom redirects: Send payers to a thank-you page after successful payment
Personalized messages: Display custom success messages upon completion
Email notifications: Both sender and receiver get real-time updates
Callback URLs: Optional webhook for instant integration with your app

🧾 Request Body

Parameter	Type	Description
`uuid`	`string`	Required. Unique identifier of the user creating the payment link
`type`	`string`	Required. Payment type: `onetime` or `recurring`
`currency`	`string`	Required. Currency code (e.g., `NGN`, `USD`, `GBP`)
`amount`	`number`	Required. Amount to be collected
`name`	`string`	Required. Name of the payment link (e.g., "Pandascrow Marketplace")
`description`	`string`	Required. Description of what's being paid for
`is_phone_required`	`boolean`	Whether to require phone number from the customer
`is_custom_link`	`boolean`	Whether to use a custom URL slug
`link_slug`	`string`	(Conditional) Custom slug for the payment link (e.g., `pandascrow-merch`). Required if `is_custom_link` is `true`.
`redirect_link`	`string`	URL to redirect customers to after successful payment
`success_message`	`string`	Custom success message to display after payment

📦 Example Request

{
  "uuid": "4b5c12fb-74f8-4dd5-b700-f825b29e7719",
  "type": "onetime",
  "currency": "NGN",
  "amount": 10000,
  "name": "Pandascrow Marketplace",
  "description": "One-time payment for Pandascrow merch",
  "is_phone_required": true,
  "is_custom_link": true,
  "link_slug": "pandascrow-merch",
  "redirect_link": "https://app.pandascrow.io/thank-you",
  "success_message": "Thanks for your payment!"
}