Build crypto escrow into your own platform.

Three ways to offer Vaultion escrow

Pick the one that fits how you build. They all open the same escrow contracts.

How an API escrow works

You never touch the funds or a wallet key. The contract holds them, the chain proves every step.

1. 01

   Your server creates a checkout

   One POST with the order, the price in US cents and the seller’s wallet address. You get back a checkout link.

2. 02

   The buyer funds escrow

   On Vaultion’s hosted page, from their own wallet. The funds lock in the escrow smart contract, not with Vaultion and not with you.

3. 03

   You read the status

   Poll the session: escrow_funded means deliver. The seller has not been paid yet.

4. 04

   Delivery confirmed, seller paid

   The buyer releases, or the seller claims after the review period. A dispute goes to Vaultion-assisted human arbitration.

Escrow only, or payments too

One field decides what the buyer is offered. Change it per order.

API reference

Base URL https://checkout.vaultion.org. JSON in, JSON out. Call it from your server: browser calls from other sites are refused, which keeps the price and the seller’s address out of the buyer’s hands. Import the OpenAPI spec into Postman or your code generator.

// Runs on your server. Never in the browser.
const res = await fetch('https://checkout.vaultion.org/v1/stores/sessions', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    store: { url: 'https://yourplatform.com', name: 'Your Platform', email: '[email protected]' },
    orderRef: 'order-1042',
    name: 'Logo design: final files',
    priceMinor: 25000,          // $250.00
    escrow: 'required',         // escrow only
    receiving: { evm: '0xSellerWalletAddress' },
    returnUrl: 'https://yourplatform.com/orders/1042',
  }),
});
const session = await res.json();
if (!res.ok) throw new Error(session.error);   // e.g. escrow_below_minimum

// Send the buyer here:
const checkoutUrl = 'https://checkout.vaultion.org' + session.checkoutPath;

// Later: read the status
const status = await fetch('https://checkout.vaultion.org/v1/stores/sessions/' + session.sessionId)
  .then((r) => r.json());
if (status.status === 'escrow_funded') { /* deliver: funds are locked */ }
if (status.status === 'escrow_released') { /* the seller is paid */ }

GET https://checkout.vaultion.org/v1/stores/sessions/9f2c…

{
  "sessionId": "9f2c…",
  "status": "escrow_funded",
  "network": "base",
  "label": "Base",
  "explorer": "https://basescan.org",
  "settlement": {
    "txHash": "0x…",
    "escrowId": "17",
    "escrowContract": "0x…"
  },
  "attempts": [ … ]
}

POST https://checkout.vaultion.org/v1/stores/check
{ "store": {…}, "receiving": {…}, "escrow": "required" }

→ { "merchantId": "store_…",
    "networks": ["base", "ethereum", "polygon", "arbitrum", "bsc"],
    "escrowNetworks": ["base", "ethereum", "arbitrum", "bsc", "tron", "solana"] }

Escrow links: no code

Put the deal in a vaultion.org/pay link and the buyer lands on the escrow form already filled in. Build links in your own code, or make one by hand with the payment link tool. The seller follows the escrow by email.

https://vaultion.org/pay?to=0xSellerWalletAddress&amt=250&net=8453&token=USDC&days=7&title=Logo%20design&sn=Alex&se=alex%40example.com

Short links

Long links look suspicious in chat apps. Store the query and share an 8-character link that unfurls with a preview card. Short links last 180 days.

POST https://vaultion.org/api/paylink
{ "q": "to=0xSellerWalletAddress&amt=250&net=8453&token=USDC&title=Logo%20design" }

→ { "ok": true, "code": "k7Qm2xPa" }      // share https://vaultion.org/p/k7Qm2xPa

Links have no status API: use the API above when your platform needs to know when an escrow is funded or released.

Pricing

No monthly fee, no setup fee, nothing to pay for API calls. Network gas is additional and shown before the buyer authorizes.

Questions developers ask

Read the payments service terms and privacy notice.