API Reference
API reference
Quick reference for the V1 (E-PRO compatible) endpoints
Endpoints
| Endpoint | Method | Summary |
|---|---|---|
/v1/payment/direct | POST | Authorize (and capture) a card payment |
/v1/refund/direct | POST | Refund a previously captured payment (full) |
/v1/status/direct | POST | Query the current status of a transaction |
Base URL
https://api.settleflow.ioSandbox and production share the same host — the sk_test_ / sk_live_ prefix on your API key selects the environment. See Sandbox & test cards.
Common request shape
POST /v1/<action>/direct HTTP/1.1
Host: api.settleflow.io
Content-Type: application/json
epro-api-key: sk_test_...Common response shape
Success:
{
"Code": 0,
"Result": {
/* operation-specific */
}
}Error (HTTP 200 with a non-zero Code):
{ "Code": 206, "Error": "Invalid parameter CardNumber, check format or Luhn algorithm" }The full catalog of codes lives on the Error codes page.
Shared result fields
Every Result envelope — payment, refund, status — exposes the following:
| Field | Type | Description |
|---|---|---|
OperationType | enum | payment, refund, credit |
Status | enum | authorized, captured, failed, cancelled, pending, rejected_pw |
Tid | string | Your transaction reference |
Reference | string | SettleFlow identifier |
Amount | number | Amount in major currency units |
UserId | string | Your Uid supplied on the original payment |
Message | string | Human-readable outcome |
Date | string | YYYY-MM-DD HH:mm:ss (UTC) |