Easy Labs
APIPaymentsTransfer

Get a transfer by ID (deprecated alias)

**Deprecated** — use `/v1/api/payment` instead. This path is kept for SDK back-compat and will be removed in a future major release. Both paths share the same handlers; only the URL differs. Retrieve a payment by its ID. `expand` accepts comma-separated keys: merchant, merchant_identity, instrument, parent. `scope=company` widens scoping from the auth context's primary merchant to all the company's merchants.

GET
/v1/api/transfer/{id}

Authorization

apiKey
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

expand?string
scope?string
Value in"merchant" | "company"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/v1/api/transfer/string"
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "data": {
    "id": "TRxxxxxxxxxxxxxxxxxx",
    "amount": 5000,
    "currency": "USD",
    "state": "SUCCEEDED",
    "identity_id": "IDxxxxxxxxxxxxxxxxxx",
    "payment_instrument_id": "PIxxxxxxxxxxxxxxxxxx",
    "tags": {},
    "created_at": "2026-01-15T00:00:00.000Z",
    "updated_at": "2026-01-15T00:00:00.000Z"
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}

Create a transfer (deprecated alias)

**Deprecated** — use `/v1/api/payment` instead. This path is kept for SDK back-compat and will be removed in a future major release. Both paths share the same handlers; only the URL differs. Charge a customer's payment instrument. Body mirrors Finix's POST /transfers payload. The merchant defaults to the API-key/JWT context but can be overridden for sub-merchant routing.

Get transfers (deprecated alias)

**Deprecated** — use `/v1/api/payment` instead. This path is kept for SDK back-compat and will be removed in a future major release. Both paths share the same handlers; only the URL differs. Retrieve a list of payments. Filters: `type` (DEBIT/CREDIT/REVERSAL/FEE/ADJUSTMENT/DISPUTE/RESERVE/SETTLEMENT/UNKNOWN), `subtype`, `parent_transfer`, `source`, `merchant` (override scoping; must be company-owned). `scope=company` widens scoping from the auth context's primary merchant to all the company's merchants. `expand` accepts comma-separated keys: merchant, merchant_identity, instrument, parent.