Smart payments

Beta

Create instant settlement payment

post

https://api.evolvepayments.com/v2https://sandbox-api.evolvepayments.com/v2

/payments/instant-settle

🧪 Beta Feature - Create a payment with instant settlement

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

Authorizations

BearerAuth

AuthorizationstringRequired

Use your API key in the Authorization header: Authorization: Bearer evo_live_your_api_key

Body

application/json

anyOptional

Responses

201

Instant settlement payment created

application/json

post

/payments/instant-settle

HTTPcURLJavaScriptPython

POST /v2/payments/instant-settle HTTP/1.1
Host: api.evolvepayments.com
Authorization: Bearer YOUR_SECRET_TOKEN
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-12-09T15:33:03.359Z",
  "updated_at": "2025-12-09T15:33:03.359Z",
  "captured_at": "2025-12-09T15:33:03.359Z",
  "metadata": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "settlement_status": "pending",
  "estimated_settlement_time": "2025-12-09T15:33:03.359Z"
}