PAID

API reference

The PAID API is REST-style, returns JSON, and uses standard HTTP verbs. Base URL: https://api.trustfabric.ai.

Authentication

Authenticate every request with your secret key:

Authorization: Bearer sk_live_yourkey

Endpoint catalog

PAID exposes over 2,500 production routes. The most commonly used endpoints are listed below. The complete catalog is available at api.trustfabric.ai/openapi.json.

Checkout

MethodPathDescription
POST/v1/checkout/sessionsCreate a checkout session.
GET/v1/checkout/sessions/{id}Retrieve a checkout session.
POST/v1/checkout/sessions/{id}/confirmConfirm a session and finalize the payment intent.

Payment intents

MethodPathDescription
POST/v1/payment_intentsCreate a payment intent directly.
GET/v1/payment_intentsList payment intents with filters.
GET/v1/payment_intents/{id}Retrieve a payment intent.
POST/v1/payment_intents/{id}/captureCapture a previously authorized intent.
POST/v1/payment_intents/{id}/cancelCancel an unauthorized intent.
POST/v1/payment_intents/{id}/refundsRefund a charge.

Accounts

MethodPathDescription
POST/v1/accountsCreate a connected account.
GET/v1/accounts/{id}Retrieve account details.
POST/v1/accounts/{id}/payoutsIssue a payout.

Reconciliation

MethodPathDescription
GET/v1/reconciliation/reportsList reconciliation reports.
GET/v1/reconciliation/reports/{id}Retrieve a report and its mismatches.
POST/v1/reconciliation/mismatches/{id}/resolveResolve a mismatch.

Errors

StatusMeaning
400Validation error. Inspect the error.code for the specific field.
401Missing or invalid API key.
402The card was declined. error.decline_code explains why.
403Authenticated but not permitted for this resource.
404Resource not found.
429Rate-limited. Back off according to the Retry-After header.
5xxServer-side. Retry idempotently with exponential backoff.

Idempotency

Every POST endpoint accepts an Idempotency-Key header. PAID stores the response keyed by (account, key) for 24 hours. Retrying with the same key returns the original response.