Smart payments

Beta

Create instant settlement payment

post

🧪 Beta Feature - Create a payment with instant settlement

This feature enables immediate fund settlement, typically completed within minutes. Available to beta testers only.

Authorizations
Body
all ofOptional
Responses
201
Instant settlement payment created
application/json
Responseall of
post
POST /v2/payments/instant-settle HTTP/1.1
Host: api.evolvepayments.com
Authorization: Bearer API Key
Content-Type: application/json
Accept: */*
Content-Length: 239

{
  "amount": 2000,
  "currency": "usd",
  "customer_id": "cus_123456789",
  "payment_method_id": "pm_987654321",
  "capture_method": "automatic",
  "metadata": {
    "order_id": "order_789",
    "invoice_id": "inv_456"
  },
  "instant_settlement": true,
  "settlement_account": "text"
}
201

Instant settlement payment created

{
  "id": "pay_123456789",
  "amount": 2000,
  "currency": "usd",
  "status": "pending",
  "customer_id": "cus_123456789",
  "payment_method_id": "pm_987654321",
  "created_at": "2025-07-31T04:18:24.050Z",
  "updated_at": "2025-07-31T04:18:24.050Z",
  "captured_at": "2025-07-31T04:18:24.050Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "settlement_status": "pending",
  "estimated_settlement_time": "2025-07-31T04:18:24.050Z"
}

Last updated