Payment InfrastructureSettlementAPI Integration
News Company Japan Talk to us
03 — API Integration

Integrate once.
Operate at scale.

Curfex exposes a structured API layer for institutional clients to submit payment instructions, monitor settlement status, retrieve reporting, and manage configurations — with full auditability and role-based access controls built in.

Talk to us Infrastructure →
Integration overview

Designed for institutional
engineering teams.

The Curfex API is built for high-volume, high-frequency payment flows. Integration gives clients programmatic access to the full capability stack — FX pricing, settlement routing, compliance controls, and reporting.

CURFEX API
# 1. Authenticate — obtain access token
POST /authenticate
→ 200 OK  ·  accessToken: ***
# 2. Request payout quote
POST /payout/quote Authorization: Bearer ***
{
  "corridor": "HKD-JPY",
  "amount": 50000
}
→ 200 OK  ·  quoteId: ***  ·  rate: ***
# 3. Submit payout
POST /payout/submit
→ 200 OK  ·  refNo: ***  ·  status: ACCEPTED
01
Payout and wallet management

Submit payout instructions, prefund wallets, and retrieve live FX quotes programmatically. Quotes are time-bounded and must be confirmed within the validity window before a payout is submitted.

02
Transfer status and event callbacks

Poll transfer state on demand or subscribe to event-driven callbacks for real-time status updates. Callbacks are cryptographically signed to allow verification on the receiving end.

03
History, receipts, and reporting

Retrieve paginated transfer records with date range and status filters. Per-transaction receipts and wallet transaction history are available for reconciliation and audit purposes.

04
User registration and KYC

Partners can register end users programmatically and manage KYC document submissions via the API. Both individual and corporate customer types are supported, with status updates delivered via callbacks.

Technical specifications

What to expect
from the integration.

The Curfex API is designed for enterprise and institutional engineering environments. Implementation support is available for qualified clients.

ProtocolREST over HTTPS — all requests and responses in JSON
EnvironmentsProduction and sandbox — base URLs provided upon onboarding
AuthenticationToken-based authentication using client credentials. Full details provided to qualified clients.
WebhooksEvent-driven callbacks for transfer and registration status updates. Callbacks are cryptographically signed for verification.
IdempotencyCallbacks include a unique event key. Partners should process each event key only once.
Rate limitsRate limiting applies — refer to Curfex developer documentation for current tier limits. Contact us for throughput requirements.
PaginationHistory endpoints support date range filters and paginated responses.
Integration path
From sandbox to production

Qualified clients receive sandbox access for integration testing, followed by a structured production onboarding process including KYB/KYC verification, compliance review, and configuration of limits, corridors, and access controls.

Support
Implementation support

Technical integration support is available throughout the onboarding process. Curfex works directly with client engineering and treasury teams to validate the integration against their specific payment flows and reporting requirements.

Ready to start
the integration?

Get in touch to discuss your payment flows, throughput requirements, and corridor needs. API documentation and sandbox access are available to qualified clients.

Talk to us
© 2026 Curfex (HK) Limited  ·  Room 05-159, 5/F The Quayside, 77 Hoi Bun Road, Kwun Tong, Kowloon, Hong Kong Licensed Money Service Operator  ·  Customs & Excise Department, Hong Kong