XICUI Payments
|

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'

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.

Core Endpoints

POST/v1/payments
GET/v1/payments/{id}
GET/v1/fx/rates
POST/v1/fx/convert
GET/v1/accounts/balance
POST/v1/suppliers

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.