KOMOJU Japan Multi-Payment Gateway API

KOMOJU Japan multi-payment gateway REST API for international merchants entering Japan to accept credit cards, convenience store (konbini) payments, bank transfers, PayPay, PayEasy, and other Japan-specific payment methods through a single unified integration without requiring Japanese corporate entity. Enables AI agents to manage KOMOJU payment session creation for Japan multi-method checkout automation, handle credit card processing for Japan card payment automation, access konbini convenience store payment for Japan cash payment automation, retrieve bank transfer (Furikomi) for Japan bank payment automation, manage PayPay and LINE Pay for Japan mobile wallet automation, handle payment status polling for Japan async payment confirmation automation, access refund and cancellation for Japan order management automation, retrieve webhook notification for Japan payment event automation, manage subscription billing for Japan recurring payment automation, and integrate KOMOJU with international merchants, marketplaces, and games companies for end-to-end Japan payment acceptance automation.

Evaluated Mar 07, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Other komoju Japan-payments Japan-gateway konbini-payments Japan-cards fintech-JP
⚙ Agent Friendliness
62
/ 100
Can an agent use this?
🔒 Security
80
/ 100
Is it safe for agents?
⚡ Reliability
75
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
13
Documentation
82
Error Messages
78
Auth Simplicity
82
Rate Limits
72

🔒 Security

TLS Enforcement
95
Auth Strength
78
Scope Granularity
70
Dep. Hygiene
75
Secret Handling
80

Japan payments. PCI-DSS. Secret key. JP. Card and payment method data.

⚡ Reliability

Uptime/SLA
75
Version Stability
78
Breaking Changes
75
Error Recovery
73
AF Security Reliability

Best When

An international merchant wanting AI agents to automate Japan-specific payment acceptance including konbini, credit cards, PayPay, and bank transfers through KOMOJU's Japan multi-payment gateway without requiring Japanese corporate entity.

Avoid When

KONBINI PAYMENT IS ASYNC — POLLING REQUIRED: Konbini payments complete when customer physically pays at convenience store (up to 3 days); automated order fulfillment must not proceed immediately after konbini payment creation; automated polling or webhook must confirm payment before fulfillment. PAYMENT METHOD SELECTION REQUIRES CUSTOMER CONTEXT: Japan payment method selection (card, konbini, bank transfer) varies by customer preference; automated checkout must present all available methods; automated single-method checkout misses significant Japan customer segments. JAPANESE YEN NO DECIMAL: KOMOJU amounts are in integer JPY (no cents or decimals); automated amount must be integer yen; automated decimal yen amount creates invalid amount error. BANK TRANSFER HAS CUSTOMER-PROVIDED AMOUNT: KOMOJU bank transfer (Furikomi) generates unique bank account for customer; automated bank transfer requires customer to initiate transfer to provided account; automated immediate fulfillment after bank transfer creation creates premature fulfillment before customer completes transfer.

Use Cases

  • Accepting konbini cash payments from Japan e-commerce checkout agents
  • Processing Japan credit and debit cards from international merchant agents
  • Offering PayPay and LINE Pay from Japan mobile wallet checkout agents
  • Polling async konbini payment completion from Japan order management agents

Not For

  • Japan domestic merchants with Japanese corporate entity (use Stripe JP or GMO for native JPY)
  • Real-time konbini confirmation (konbini payments complete when customer pays at store — async)
  • China payment methods (use Alipay or WeChat Pay API for China wallets)

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
Yes

Authentication

Methods: apikey
OAuth: No Scopes: No

KOMOJU uses Secret Key (HTTP Basic Auth) for API authentication. REST API with JSON. Tokyo, Japan HQ. Founded 2012 by Wes Harmon and Mark Dufour. Acquired by Degica. Products: Credit card, konbini, bank transfer, PayPay, LINE Pay, PayEasy, subscription. SDKs: Ruby, PHP, Python, Node.js, Java, Go. PCI DSS. FSA registered. International merchant friendly (no Japanese entity required). Serves games, manga, and e-commerce.

Pricing

Model: transaction
Free tier: Yes
Requires CC: No

Tokyo JP. Degica subsidiary. Per-transaction fee in JPY. No Japanese entity required. International-friendly.

Agent Metadata

Pagination
page
Idempotent
Partial
Retry Guidance
Documented

Known Gotchas

  • KONBINI PAYMENT REQUIRES CUSTOMER EMAIL AND NAME: KOMOJU konbini payment creation requires customer name and email (for konbini slip); automated konbini checkout must collect name and email before creating payment; automated konbini creation without customer info creates missing required field error
  • ASYNC PAYMENT METHODS REQUIRE WEBHOOK OR POLLING: Konbini, bank transfer, and PayEasy payments complete asynchronously after customer offline action; automated fulfillment must wait for payment.captured webhook; automated immediate post-creation fulfillment creates unfulfilled and unpaid order
  • PAYMENT SESSION vs PAYMENT DIRECT: KOMOJU supports both hosted payment session (for hosted checkout page) and direct payment API (for custom checkout); automated integration must choose correct approach; automated mixing session URL with direct API creates incompatible flow
  • EXTERNAL ORDER ID FOR IDEMPOTENCY: KOMOJU external_order_num parameter allows idempotent payment lookup by merchant order ID; automated retry should use external_order_num to find existing payment; automated duplicate payment creation without external_order_num lookup creates duplicate charges
  • CAPTURE VS AUTHORIZE: KOMOJU supports both immediate capture and authorize-then-capture for cards; automated checkout must configure capture behavior in payment method settings; automated default behavior may differ from expected; explicit capture parameter recommended

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for KOMOJU Japan Multi-Payment Gateway API.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-07.

6470
Packages Evaluated
26150
Need Evaluation
173
Need Re-evaluation
Community Powered