A single-use escrow contract for fixed-price projects or purchases.
🧾 One-Time Escrow
Create a one-time escrow contract between a buyer and a seller. This type of escrow is ideal for single, non-recurring payments tied to a specific project, product, or service.
📌 Use Case
Use this endpoint when you want to:
- Secure payment for a one-off service (e.g., freelance work) or product (e.g., e-commerce sale).
- Define delivery expectations, inspection periods, and dispute resolution preferences.
- Support both freelancers and merchants looking to transact safely with clients or customers.
- Provide buyer and seller contact details for transparency and documentation.
🧰 Features
- Supports multiple currencies (e.g.
USD,NGN) - Inspection and dispute windows to protect both parties
- Optional PRD or documentation file URL
- Callback URL for webhook updates
🧾 Example Use Case
- A freelance designer and a client agree on a
$500logo design project. The client (buyer) funds the escrow. The designer (seller) completes the work. After a 5-day inspection period, the funds are released. - An online merchant sells a custom furniture piece for
$1,200. The buyer pays into escrow. Once the product is delivered and inspected, the funds are released to the seller.
🧱 Required Fields
| Field | Type | Description |
|---|---|---|
uuid | string | A unique reference for the escrow session |
initiator_role | string | Role of the initiator: buyer, seller, or broker |
escrow_type | string | Should be set to "onetime" |
amount | number | Total amount to be held in escrow |
currency | string | Currency code (e.g. USD, NGN) |
title | string | Short title of the transaction |
description | string | Detailed description of the service or product |
delivery_date | string | Expected delivery date in YYYY-MM-DD format |
inspection_period | string | Number of days the buyer has to inspect the delivery |
dispute_window | string | Number of days available to open a dispute after delivery |
how_dispute_is_handled | string | Dispute method: platform or arbitration |
who_pay_fees | string | Who covers transaction fees: buyer, seller, or split |
prd_url | string | (Optional) URL of uploaded project brief or product document |
callback_url | string | (Optional) URL to receive webhook events |
buyer_details | object | Object containing name, email, and phone of the buyer |
seller_details | object | Object containing name, email, and phone of the seller |
🔒 Security
All escrows created through this endpoint are:
- Verified with identity data of the parties involved
- Logged and tracked through Pandascrow’s escrow lifecycle engine
- Automatically managed with status updates and notifications