統一決済 API
HTTP + JSON で注文作成、状態照会、返金を実行。
越境決済を、もっと明快で確実に。
注文から入金まで、決済、返金、通知、出金を一つのサーバー API で管理。チームは事業に集中できます。
注文が入り、資金が着金する。
Fig. 1イメージ用の数値です
- 統一 API
- HTTP + JSON
- 既存のサーバーに対応
- テストと本番を分離
- 2 つの環境
- キーの接頭辞で区別
- 署名付き通知
- HMAC-SHA256
- 信頼できる非同期イベント
- 保留中の取引
- 自動照合
- 最終状態を継続確認
- 無料テスト環境
- ホスト型決済
- 検証可能な Webhook
01プラットフォーム
決済に必要な機能を一つに
状態を照会でき、資金の動きも追跡できます。
ホスト型決済
署名付きリンクを利用し、決済情報を自社で扱わずに済みます。
環境の分離
テストと本番で別のキーを使い、誤った本番取引を防ぎます。
確実な Webhook
署名検証、失敗時の再送、配信履歴、手動再送に対応。
自動照合
通知が届かない場合も、保留中の決済と返金を再確認します。
ウォレットと台帳
入金、返金、出金の残高変動を追跡できます。
02決済手段と料金
受け付けられる決済と料金
プラットフォームの標準条件です。審査済みの加盟店は契約料率を加盟店ポータルで確認できます。
- 決済手段
- カード
- Apple Pay
- Google Pay
- Alipay
- WeChat Pay
- PayPal
- テスト環境ではすべての手段を利用できます。本番の決済手段は審査時に加盟店ごとに有効化され、ポータルから追加を申請できます。
- 通貨
- USD · HKD · CNY
- 通貨ごとに独立したウォレットで、同じ通貨で出金します。自動両替はありません。
- 標準料金
- 3.5% + 固定手数料
- 決済成功 1 件ごと。固定手数料は $0.30 · HK$2.35 · ¥2.00。手数料が注文金額を超えることはありません。
03開発者のために
一つのリクエストで決済を開始
サーバーで注文を作成し、返された決済 URL に購入者を転送します。注文参照番号は冪等キーとしても機能します。
リクエスト
curl -X POST https://api.kukopay.com/v1/orders \
-H "X-Api-Key: kuko_test_•••" \
-H "Content-Type: application/json" \
-d '{
"out_trade_no": "ORD_2026_001",
"amount": 2990,
"currency": "USD",
"subject": "Premium plan"
}'レスポンス 201
{
"code": 201,
"data": {
"trade_no": "TRD_SB_9F3A2C7E…",
"status": "pending",
"checkout_url": "https://checkout.kukopay.com/…"
}
}注文金額
$29.90 USD
ORD_2026_001
テスト環境支払い済み
決済のライフサイクル
- 注文を作成
POST /v1/orders - 決済画面を表示
checkout_url - 支払い完了
payment.succeeded - Webhook 配信済み
HTTP 200 - 台帳に記帳
+ $29.90
Fig. 2画面イメージ（実際の取引ではありません）
クイックスタートを見る04連携方法
システムに合った最短の連携方法を
どの方法でも同じ注文、同じホスト型決済画面、同じ精算と通知になります。違いはコードを誰が書くかだけです。
05導入の流れ
4 ステップで決済を完結
ブラウザーの戻り先は表示用です。履行の判断には署名検証済みの通知を使用します。
- 01
テストキーを取得
加盟店登録後、テストキーを申請して連携を開始。
- 02
注文を作成
金額、注文番号、通知先を送信して決済リンクを取得。
- 03
購入者が支払う
KukoPay のホスト型決済画面へ転送。
- 04
検証して履行
payment.succeeded を検証し、イベント ID で重複を排除。
06セキュリティ設計
安全策をフローに組み込む
環境分離、署名検証、台帳の制約により操作ミスを抑えます。
キーの保護
キーを暗号化して保存し、加盟店側で再発行可能。
アクセス制御
加盟店単位の制限と任意の IP 許可リスト。
環境分離
テストと本番は独立したキーと台帳を使用。
資金の整合性
残高変更と冪等な状態遷移を記録。
07よくある質問
導入前に確認したいこと
KukoPay とは何ですか？
KukoPay は越境ビジネス向けの決済ゲートウェイです。サーバーから API を一度呼び出して注文を作成し、購入者を KukoPay のホスト型決済画面に案内します。決済結果を決済チャネルに確認したうえで、その通貨のウォレットに入金し、署名付き Webhook で通知します。返金、チャージバック、照合、出金も同じ API と加盟店ポータルで行えます。
対応している決済手段と通貨は？
カード、Apple Pay、Google Pay、Alipay、WeChat Pay、PayPal に対応し、通貨は USD、HKD、CNY です。テスト環境ではすべて利用でき、本番の決済手段と通貨は審査時に加盟店ごとに有効化され、ポータルから追加を申請できます。通貨ごとに独立したウォレットで、自動両替はありません。
料金はいくらですか？
標準料金は決済成功 1 件あたり 3.5% + 固定手数料（USD は $0.30、HKD は HK$2.35、CNY は ¥2.00）で、手数料が注文金額を超えることはありません。契約時に決済手段のグループごとに料率を設定でき、適用された料率は注文ごとに記録されます。テスト環境は無料です。
法人でなくても利用できますか？
はい。中国本土の法人、個人事業主、中国本土以外で登記された法人に加え、18 歳以上の個人も本人の身分証明書で申し込めます。個人の加盟店には受付限度額があり、出金先は本人名義の個人口座に限られ、デジタル商品とオンラインゲームは扱えません。
コードを書かずに決済を受け付けられますか？
はい。決済リンクはコード不要です。一般的な決済プロトコルに対応したシステムはゲートウェイ URL とキーを入力するだけで接続でき、対応プラットフォームには既製のプラグインがあります。返金、照合、チャージバックの証拠提出は加盟店ポータルで行えます。
API ドキュメントはどこにありますか？
公開資料は kukopay.com/docs、キーや注文、Webhook の配信履歴は加盟店ポータルで確認できます。
注文や提供の重複を防ぐには？
注文作成時は一意の out_trade_no を使用し、Webhook はイベント ID で重複排除します。タイムアウト時は同じ注文番号で再試行できます。
ブラウザーの戻り先で支払い完了と判断できますか？
いいえ。payment.succeeded の署名を検証してから提供し、必要に応じて注文照会で確認してください。