Safely

Developers

Put escrow inside your own checkout.

The same REST API that powers the Safely app is available to marketplaces and platforms. Create deals, take payment and release funds from your own product.

Request API accessEndpoint reference

Bearer tokens

Authenticate with a short-lived access token and refresh it with your refresh token.

JSON everywhere

Every response is { success, data, error }, with amounts as decimal strings or integer cents.

Status events

Platform partners can receive status changes (funded, shipped, released) as webhooks — set up during onboarding.

Sandbox

Build against a test environment with test card payments before you go live.

Quick start

Create your first escrow

curl -X POST https://safely.kurasika.tech/api/escrow/transactions \
  -H "Authorization: Bearer $SAFELY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Toyota Hilux 2019 — 84,000 km",
    "description": "Sold as inspected, papers included",
    "amount": "18500.00",
    "currency": "USD",
    "counterparty_email": "seller@example.com",
    "counterparty_role": "seller",
    "acceptance_window_days": "3",
    "who_pays_fees": "split"
  }'

Reference

Core endpoints

Base URL https://safely.kurasika.tech/api

POST/auth/loginExchange email and password for an access and refresh token
POST/auth/refreshGet a new access token with a refresh token
GET/auth/meThe signed-in user
POST/escrow/transactionsCreate an escrow transaction
GET/escrow/transactionsList transactions (limit, offset)
GET/escrow/transactions/{id}Fetch one transaction
PUT/escrow/transactions/{id}/statusMove a transaction to its next status (e.g. shipped)
POST/escrow/transactions/{id}/fundFund a transaction with a payment method
POST/escrow/transactions/{id}/releaseRelease held funds to the seller
POST/escrow/transactions/{id}/refundRefund held funds to the buyer
GET/escrow/transactions/{id}/messagesRead the deal conversation
POST/escrow/transactions/{id}/messagesPost a message to the deal
GET/escrow/statsTotals for the signed-in user
GET/wallets/{userId}Wallet balances: available, in escrow, pending (cents)
Need an endpoint that isn’t listed? Talk to us

Building a marketplace?

We’ll help you design the escrow flow and get your sellers paid safely.

Create a free account Talk to our team