Two integration modes

Choose direct gateway control or PayCore hosted All-in-One checkout.

Direct Gateway API is for teams that send gateway credentials per request. Project Checkout API is for merchants that save payment credentials in PayCore and only use a project API key to create orders.

Open docs center Compare integration modes View API catalog

Direct vs. All-in-One

Both modes can coexist. Direct Gateway API keeps maximum control at the merchant system. All-in-One checkout turns PayCore into the hosted payment method selector.

Direct Gateway API

Do not store gateway keys in PayCore

The merchant system calls a specific gateway and method, then sends the gateway credentials with the order request.

Endpoint: POST /api/paycore/pay/{gateway}/{method}
Credential field: gateway_credentials
Best for single-gateway or engineering-led integration

Project Checkout API

Store gateway keys and use PayCore project key

The merchant creates a PayCore payment project and stores multiple gateway credentials under it. The merchant system only sends the PayCore project API key when creating an order.

Endpoint draft: POST /api/paycore/checkout
Credential field: project_api_key
Best for hosted All-in-One payment pages

All-in-One checkout flow

Merchant creates payment project in PayCore Merchant Center

Merchant binds SmilePay, ECPay, PLUS, Stripe or other gateway credentials

Merchant system creates an order with project_api_key

PayCore returns checkout_url

Payer selects a payment method on PayCore checkout

PayCore uses the bound gateway credential to create the actual gateway payment

Gateway calls PayCore webhook

PayCore updates payment status and notifies merchant notify_url

PayCore開発者センターは公開されています。Direct Gateway API、All-in-One決済プロジェクト、Webhook、エラーコード例を順次追加します。