Developer Portal
Build on XICUI's Payment Rails
A modern, API-first payment infrastructure for China trade. RESTful APIs, webhooks, and SDKs — everything you need to embed payments into your application.
payment.ts
import XicuiPayments from '@xicui/payments';
const client = new XicuiPayments({
apiKey: process.env.XICUI_API_KEY,
environment: 'sandbox', // or 'production'
});
// Initiate a CNY payment to a Chinese supplier
const payment = await client.payments.create({
amount: 284500,
currency: 'CNY',
supplier: {
bankAccount: '6222021234567890',
bankCode: 'ICBKCNBJ',
name: 'Guangzhou Textile Co. Ltd',
},
reference: 'PO-2026-0891',
});
console.log(payment.id); // txn_8821abc
console.log(payment.status); // 'processing'Quickstart
Up and running in minutes
01
Get API Keys
Sign up for a developer account and generate your API keys from the dashboard.
02
Install SDK
Install our SDK for your language of choice: Node.js, Python, PHP, or Java.
03
Make Your First Call
Use the sandbox environment to test payments before going live.
API Reference
Core Endpoints
POST
/v1/paymentsGET
/v1/payments/{id}GET
/v1/fx/ratesPOST
/v1/fx/convertGET
/v1/accounts/balancePOST
/v1/suppliersSDKs
Official SDKs
Node.js
npm install @xicui/payments
Python
pip install xicui-payments
PHP
composer require xicui/payments
Java
implementation 'com.xicui:payments:1.0.0'
Sandbox Environment
Test all API calls in a fully isolated sandbox before going live. No real money moved.
Webhooks
Real-time event notifications for payment status changes, FX rate alerts, and more.
Full Documentation
Comprehensive API reference, guides, and code examples for every endpoint.
Ready to start building?
Get your API keys and start integrating XICUI Payments into your application today.