Buy Chinese Yuan
with Naira - Fund
Alipay, WeChat & Bank
instantly

200 OK  58ms

{
  "data": {
    "channels": [
      {
        "channel":      "alipay",
        "name":         "Alipay",
        "is_available": true,
        "account_types": [
          {
            "type":         "nigerian",
            "name":         "Nigerian Alipay Account",
            "is_available": true,
            "rates": [
              {
                "min_rmb":     100,
                "max_rmb":     5000,
                "ngn_per_rmb": 196.5
              }
            ]
          },
          {
            "type":         "chinese",
            "name":         "Chinese Alipay Account",
            "is_available": true,
            "rates": [
              {
                "min_rmb":     100,
                "max_rmb":     5000,
                "ngn_per_rmb": 198.5
              }
            ]
          }
        ]
      },
      {
        "channel":        "wechat",
        "name":           "WeChat Pay",
        "is_available":   true,
        "account_types": [
          {
            "type":         "nigerian",
            "name":         "Nigerian WeChat Pay Account",
            "is_available": true,
            "rates": [
              {
                "min_rmb":     100,
                "max_rmb":     5000,
                "ngn_per_rmb": 197.5
              }
            ]
          },
          {
            "type":         "chinese",
            "name":         "Chinese WeChat Pay Account",
            "is_available": true,
            "rates": [
              {
                "min_rmb":     100,
                "max_rmb":     5000,
                "ngn_per_rmb": 199.5
              }
            ]
          }
        ]
      },
      {
        "channel":      "bank",
        "name":         "Chinese Bank Account",
        "is_available": true,
        "rates": [
          {
            "min_rmb":     100,
            "max_rmb":     5000,
            "ngn_per_rmb": 195.5
          }
        ]
      }
    ],
    "limits": {
      "min_rmb":        100.0,
      "max_rmb":        100000.0,
      "currency":       "CNY"
    },
    "endpoints": {
      "buy":            "POST /v1/rmb/buy"
    }
  }
}

POST https://api.sogo.africa/v1/rmb/buy
Authorization:   Bearer sogo_sk_live_••••••••••••••••
Content-Type:    multipart/form-data
Idempotency-Key: 3b4a1f82-d81c-47e3-b9a3-557744330001

# WeChat Pay orders: use multipart/form-data, qr_code is required
# recipient_identifier is optional when qr_code is provided
channel=wechat
wechat_account_type=nigerian
rmb_amount=500
qr_code=<recipient's WeChat Pay receive QR code image>
recipient_name=Li Fang
recipient_identifier=lifang_wx   # optional, helps admin identify the account
description=Freight agent payment - Guangzhou logistics

201 Created  134ms

{
  "message": "Your RMB order has been submitted. Your wallet has been debited. You will be notified when the order is processed.",
  "data": {
    "id":                   "8a67d022-f94b-4654-8c88-2ffba8de9dbb",
    "reference":            "SBXRMB24J4P21F",
    "channel":              "alipay",
    "alipay_account_type":  "nigerian",
    "wechat_account_type":  null,
    "rmb_amount":           1000,
    "ngn_amount": {
      "raw":                196500.0,
      "formatted":          "NGN 196,500.00",
      "currency":           "NGN"
    },
    "exchange_rate":        196.5,
    "recipient_name":       "Zhang Wei",
    "recipient_identifier": "+8613812345678",
    "description":          "Trade payment - fabric import",
    "status":               "processing",
    "created_at":           "2026-05-24T10:30:00.000000Z"
  }
}

// PHP - purchase ¥1,000 CNY via Alipay (multipart/form-data, QR code required for Alipay and WeChat Pay)
// For WeChat Pay: set channel='wechat' and replace alipay_account_type with wechat_account_type ('nigerian' or 'chinese')
$client = new \GuzzleHttp\Client;

$multipart = [
    ['name' => 'channel',              'contents' => 'alipay'],
    ['name' => 'alipay_account_type',  'contents' => 'nigerian'],
    ['name' => 'rmb_amount',           'contents' => (string)(float)$request->rmb_amount],
    // Required for Alipay and WeChat Pay: the recipient's receive QR code image
    ['name' => 'qr_code', 'contents' => fopen($request->qrCodePath, 'r'), 'filename' => 'qr.jpg'],
    ['name' => 'recipient_name',       'contents' => $request->recipient_name],
    ['name' => 'description',          'contents' => $request->description],
];

// recipient_identifier is optional for alipay/wechat when qr_code is supplied
if (!empty($request->recipient_identifier)) {
    $multipart[] = ['name' => 'recipient_identifier', 'contents' => $request->recipient_identifier];
}

$response = $client->post('https://api.sogo.africa/v1/rmb/buy', [
    'headers'   => [
        'Authorization'   => 'Bearer ' . getenv('SOGO_SECRET_KEY'),
        'Idempotency-Key' => \Ramsey\Uuid\Uuid::uuid4()->toString(),
    ],
    'multipart' => $multipart,
]);

$data = json_decode($response->getBody(), true)['data'];
// Save $data['reference'] to track the webhook

import { randomUUID } from 'crypto';
import { readFileSync } from 'fs';

// Alipay and WeChat Pay orders require multipart/form-data with a qr_code image
// For WeChat Pay: set channel='wechat' and use wechat_account_type ('nigerian' or 'chinese') instead
const form = new FormData();
form.append('channel',              'alipay');
form.append('alipay_account_type',  'nigerian');
form.append('rmb_amount',           String(req.body.rmbAmount));
// Required for Alipay and WeChat Pay: the recipient's receive QR code image
form.append('qr_code', new Blob([readFileSync(req.file.path)], { type: 'image/jpeg' }), 'qr.jpg');
form.append('recipient_name',       req.body.recipientName);
// recipient_identifier is optional for alipay/wechat when qr_code is supplied
if (req.body.recipientIdentifier) form.append('recipient_identifier', req.body.recipientIdentifier);
form.append('description',          req.body.description);

const res = await fetch('https://api.sogo.africa/v1/rmb/buy', {
  method: 'POST',
  headers: {
    Authorization:     `Bearer ${process.env.SOGO_SECRET_KEY}`,
    'Idempotency-Key': randomUUID(),
  },
  body: form,
});

const { data } = await res.json();
// Persist data.reference for webhook matching