API Reference
Log In
API Reference

Payment Link

Payment Link allows you to collect secure, escrow-backed payments through a shareable URL, no code or integration required.

💸 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

  1. You create a Payment Link with details like title, amount, currency, and description.
  2. We generate a unique link (e.g., https://app.pandascrow.io/i/pandascrow-merch)
  3. Share the link via email, chat, social media, or your website.
  4. 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

ParameterTypeDescription
uuidstringRequired. Unique identifier of the user creating the payment link
typestringRequired. Payment type: onetime or recurring
currencystringRequired. Currency code (e.g., NGN, USD, GBP)
amountnumberRequired. Amount to be collected
namestringRequired. Name of the payment link (e.g., "Pandascrow Marketplace")
descriptionstringRequired. Description of what's being paid for
is_phone_requiredbooleanWhether to require phone number from the customer
is_custom_linkbooleanWhether to use a custom URL slug
link_slugstring(Conditional) Custom slug for the payment link (e.g., pandascrow-merch). Required if is_custom_link is true.
redirect_linkstringURL to redirect customers to after successful payment
success_messagestringCustom 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!"
}