curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/escrow/hold \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Idempotency-Key: order-1234-hold' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "9a8b7c6d-...",
    "amount": 200.00,
    "description": "Order #1234 held pending delivery"
  }'

from hostpay import HostPay

client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")

hold = client.escrow.hold(
    wallet_id="9a8b7c6d-...",
    amount=200.00,
    description="Order #1234 held pending delivery",
    idempotency_key="order-1234-hold",
)
print(hold["id"], hold["status"])

import { HostPay } from "@hostpay/sdk";

const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });

const hold = await client.escrow.hold({
  walletId: "9a8b7c6d-...",
  amount: 200.0,
  description: "Order #1234 held pending delivery",
  idempotencyKey: "order-1234-hold",
});
console.log(hold.id, hold.status);

{
  "id": "b1f2c3d4-...",
  "wallet_id": "9a8b7c6d-...",
  "escrow_wallet_id": "5e4f3a2b-...",
  "recipient_wallet_id": null,
  "application_wallet_id": null,
  "amount": 200.0,
  "escrow_amount": 200.0,
  "application_fee": null,
  "transaction_type": "escrow_hold",
  "status": "held",
  "description": "Funds held in escrow",
  "created_at": "2025-01-16T10:30:00Z",
  "updated_at": "2025-01-16T10:30:00Z"
}

{
  "detail": "Insufficient funds to hold in escrow"
}

{
  "detail": "Invalid credentials"
}

{
  "detail": "Escrow feature is not enabled for this application"
}

{
  "detail": "Sender wallet not found"
}