メインコンテンツへスキップ
このページで

このカタログを使用して、以前のDEUNA APIリファレンスから移行された操作を確認してください。移行マトリクスでは、公開済みの各メソッドとパスを1回だけ対応付け、その他のAPI Gatewayルートを除外します。

公開済みエンドポイントのインベントリ#

このインベントリは有効なAPI Gateway設定から生成され、レビュー済みの移行マトリクスによって対象が制限されています。フィルターを使用して、操作の呼び出し元、担当サービス、対応する認可方式、ゲートウェイが受け付けまたは転送するヘッダーを確認してください。

このカタログには、以前の公開APIリファレンスに存在した加盟店バックエンドおよび顧客アプリケーション向けの操作のみが含まれます。内部Admin、管理、パートナー、プロバイダーコールバック、およびその他のゲートウェイ操作は除外されています。

以下のルートは /transactions/webhooks/ DEUNA内部でプロセッサーイベントを受信するものであり、加盟店統合用エンドポイントではありません。プロバイダーが加盟店側でのコールバック設定を必要とする場合、URLと設定手順はそのプロバイダーの接続ガイドに記載されています。例として、 Stripe OXXO支払いステータスコールバック. を使用 DEUNAのウェブフック は、ご自身のバックエンドに配信される通知用です。

検証済みの公開APIインベントリ56 件の公開済み操作

以前の公開APIリファレンスから対応付けた有効なAPI Gateway操作を基に生成しています。

商社バックエンド · サーバー間 42顧客アプリケーション · ユーザーからサーバー 14
56件中56件の操作を表示
商社バックエンド · サーバー間注文、支払い、運用ワークフローのために、信頼できる商社バックエンドを使用してください。42
GET/cards/bin/{bin}
Cards and vault商社バックエンド · サーバー間

Binを取得します。

ドメイン
Cards and vault
所有サービス
Card metadata
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
X-Api-KeyX-Merchant-Id
試す
cURL の例
GET/merchants/checkout/themes
Checkout商社バックエンド · サーバー間

Themesをリストまたは取得します。

ドメイン
Checkout
所有サービス
Checkout configuration
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
POST/merchants/checkout/themes
Checkout商社バックエンド · サーバー間

Themesを作成します。

ドメイン
Checkout
所有サービス
Checkout configuration
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
DELETE/merchants/checkout/themes/{theme_id}
Checkout商社バックエンド · サーバー間

Themesを削除します。

ドメイン
Checkout
所有サービス
Checkout configuration
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
PATCH/merchants/checkout/themes/{theme_id}
Checkout商社バックエンド · サーバー間

Themesを更新します。

ドメイン
Checkout
所有サービス
Checkout configuration
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
GET/merchants/orders
Orders商社バックエンド · サーバー間

Ordersをリストまたは取得します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
POST/merchants/orders
Orders商社バックエンド · サーバー間

Ordersを作成します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Idempotency-KeyX-Prediction-Id
試す
cURL の例
GET/merchants/orders/{order_token}
Orders商社バックエンド · サーバー間

Ordersを取得します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-Keyx-merchant-id
試す
cURL の例
PATCH/merchants/orders/{order_token}
Orders商社バックエンド · サーバー間

Ordersを更新します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
POST/merchants/orders/{order_token}/expire
Orders商社バックエンド · サーバー間

OrdersのExpireを実行します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
GET/merchants/orders/{order_token}/payments-methods
Orders商社バックエンド · サーバー間

Payments Methodsをリストまたは取得します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
フローに応じて、プライベートAPIキーまたはBearerトークンを使用します。
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Store-Code
試す
cURL の例
POST/merchants/orders/{order_token}/transactions/verify
Orders商社バックエンド · サーバー間

TransactionsのVerifyを実行します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
フローに応じて、プライベートAPIキーまたはBearerトークンを使用します。
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Merchant-IDX-Store-Code
試す
cURL の例
POST/merchants/orders/{order_token}/void
Orders商社バックエンド · サーバー間

OrdersのVoidを実行します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/transactions/orders/{order_token}/installments
Orders商社バックエンド · サーバー間

Installmentsをリストまたは取得します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
フローに応じて、プライベートAPIキーまたはBearerトークンを使用します。
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Merchant-IDX-Prediction-Id
試す
cURL の例
POST/v2/merchants/orders/{order_token}/capture
Orders商社バックエンド · サーバー間

Paymentをキャプチャします。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
POST/v2/merchants/orders/{order_token}/refund
Orders商社バックエンド · サーバー間

Refundを作成します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
POST/v2/merchants/orders/purchase
Orders商社バックエンド · サーバー間

Paymentを作成します。

ドメイン
Orders
所有サービス
Orders and checkout
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキーが検証済み、存在する場合、ユーザーのBearerヘッダーが転送されます。
受け入れられるまたは転送されるヘッダー
AuthorizationCookieUser-AgentX-Api-KeyX-Device-IdX-Merchant-IDX-Prediction-IdX-Session-IdX-Store-Code
試す
cURL の例
POST/merchants/payment-links
Payment links商社バックエンド · サーバー間

Payment Linksを作成します。

ドメイン
Payment links
所有サービス
Payment links
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/payment-links/{payment_link_id}
Payment links商社バックエンド · サーバー間

Payment Linksを取得します。

ドメイン
Payment links
所有サービス
Payment links
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/payment-links/{payment_link_id}/orders
Payment links商社バックエンド · サーバー間

Ordersをリストまたは取得します。

ドメイン
Payment links
所有サービス
Payment links
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/payment-links/all
Payment links商社バックエンド · サーバー間

Allをリストまたは取得します。

ドメイン
Payment links
所有サービス
Payment links
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/stores/payments-methods
Payments商社バックエンド · サーバー間

Payments Methodsをリストまたは取得します。

ドメイン
Payments
所有サービス
Payments
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
X-Idempotency-KeyX-Merchant-IdX-Prediction-IdX-Store-Code
試す
cURL の例
GET/transactions/payments-methods
Payments商社バックエンド · サーバー間

Payments Methodsをリストまたは取得します。

ドメイン
Payments
所有サービス
Payments
対象
商社バックエンド · サーバー間
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/merchants/installments/plans/{installment_plan_option_id}
Subscriptions商社バックエンド · サーバー間

Plansを取得します。

ドメイン
Subscriptions
所有サービス
Installments
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
X-Api-Key
試す
cURL の例
GET/subscriptions
Subscriptions商社バックエンド · サーバー間

Subscriptionsをリストまたは取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions
Subscriptions商社バックエンド · サーバー間

Subscriptionsを作成します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
GET/subscriptions/{id}
Subscriptions商社バックエンド · サーバー間

Subscriptionsを取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
PATCH/subscriptions/{id}
Subscriptions商社バックエンド · サーバー間

Subscriptionsを更新します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions/{id}/cancel
Subscriptions商社バックエンド · サーバー間

SubscriptionsのCancelを実行します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
PATCH/subscriptions/{id}/cards
Subscriptions商社バックエンド · サーバー間

Cardsを更新します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions/{id}/external-settlement
Subscriptions商社バックエンド · サーバー間

External Settlementを作成します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
GET/subscriptions/{id}/history
Subscriptions商社バックエンド · サーバー間

Historyをリストまたは取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions/{id}/pause
Subscriptions商社バックエンド · サーバー間

SubscriptionsのPauseを実行します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions/{id}/resume
Subscriptions商社バックエンド · サーバー間

SubscriptionsのResumeを実行します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
GET/subscriptions/plans
Subscriptions商社バックエンド · サーバー間

Plansをリストまたは取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/subscriptions/plans
Subscriptions商社バックエンド · サーバー間

Plansを作成します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
GET/subscriptions/plans/{id}
Subscriptions商社バックエンド · サーバー間

Plansを取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
PATCH/subscriptions/plans/{id}
Subscriptions商社バックエンド · サーバー間

Plansを更新します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
GET/subscriptions/plans/statuses
Subscriptions商社バックエンド · サーバー間

Statusesをリストまたは取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
*
試す
cURL の例
GET/subscriptions/statuses
Subscriptions商社バックエンド · サーバー間

Statusesをリストまたは取得します。

ドメイン
Subscriptions
所有サービス
Subscriptions
対象
商社バックエンド · サーバー間
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
Authorizationx-Api-KeyX-Merchant-ID
試す
cURL の例
POST/users/authorize
Users and identity商社バックエンド · サーバー間

UsersのAuthorizeを実行します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキー (`X-Api-Key`)
受け入れられるまたは転送されるヘッダー
X-Api-KeyX-Merchant-Id
試す
cURL の例
POST/users/external-authorize
Users and identity商社バックエンド · サーバー間

External Authorizeを作成します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
商社バックエンド · サーバー間
サポートされている認証
プライベートAPIキーが検証済み、存在する場合、ユーザーのBearerヘッダーが転送されます。
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Auth-MessageX-Device-IdX-Merchant-Id
試す
cURL の例
顧客アプリケーション · ユーザーからサーバーユーザーのアイデンティティとデバイスコンテキストを表示した、顧客向けのウェブまたはモバイルフローを使用してください。14
GET/users/{user_id}/cards
Cards and vault顧客アプリケーション · ユーザーからサーバー

Cardsをリストまたは取得します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Merchant-ID
試す
cURL の例
DELETE/users/{user_id}/cards/{card_id}
Cards and vault顧客アプリケーション · ユーザーからサーバー

Cardsを削除します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
Authorization
試す
cURL の例
GET/users/{user_id}/cards/{card_id}
Cards and vault顧客アプリケーション · ユーザーからサーバー

Cardsを取得します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
Authorization
試す
cURL の例
PATCH/users/{user_id}/cards/{card_id}/set-as-default
Cards and vault顧客アプリケーション · ユーザーからサーバー

カードをデフォルトに設定します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Merchant-ID
試す
cURL の例
POST/v2/users/{user_id}/cards
Cards and vault顧客アプリケーション · ユーザーからサーバー

Cardsを作成します。

ドメイン
Cards and vault
所有サービス
Payments
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Merchant-ID
試す
cURL の例
GET/users/{user_id}/addresses
Users and identity顧客アプリケーション · ユーザーからサーバー

Addressesをリストまたは取得します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IdX-Merchant-Id
試す
cURL の例
POST/users/{user_id}/addresses
Users and identity顧客アプリケーション · ユーザーからサーバー

Addressesを作成します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IdX-Merchant-Id
試す
cURL の例
DELETE/users/{user_id}/addresses/{address_id}
Users and identity顧客アプリケーション · ユーザーからサーバー

Addressesを削除します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IdX-Merchant-Id
試す
cURL の例
PATCH/users/{user_id}/addresses/{address_id}
Users and identity顧客アプリケーション · ユーザーからサーバー

Addressesを更新します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IdX-Merchant-Id
試す
cURL の例
POST/users/login
Users and identity顧客アプリケーション · ユーザーからサーバー

UsersのLoginを実行します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
検証された商社アプリケーションコンテキストを持つ公開認証フロー
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Device-IdX-Merchant-IdX-Qa-Api-KeyX-Recaptcha-TokenX-Session-ID
試す
cURL の例
POST/users/logout
Users and identity顧客アプリケーション · ユーザーからサーバー

UsersのLogoutを実行します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
ゲートウェイの認証検証が宣言されていません。アクセスは、所有するサービスまたはネットワークポリシーによって制御されます。
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IDX-Session-ID
試す
cURL の例
GET/users/me
Users and identity顧客アプリケーション · ユーザーからサーバー

Meをリストまたは取得します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
認証されたユーザーのBearerトークン
受け入れられるまたは転送されるヘッダー
AuthorizationX-Device-IdX-Merchant-Id
試す
cURL の例
POST/users/register
Users and identity顧客アプリケーション · ユーザーからサーバー

UsersのRegisterを実行します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
フローに応じて、プライベートAPIキーまたはBearerトークンを使用します。
受け入れられるまたは転送されるヘッダー
X-Api-KeyX-Merchant-Id
試す
cURL の例
POST/users/request-code
Users and identity顧客アプリケーション · ユーザーからサーバー

UsersのRequest Codeを実行します。

ドメイン
Users and identity
所有サービス
Merchant management
対象
顧客アプリケーション · ユーザーからサーバー
サポートされている認証
検証された商社アプリケーションコンテキストを持つ公開認証フロー
受け入れられるまたは転送されるヘッダー
AuthorizationX-Api-KeyX-Device-IdX-Merchant-Id
試す
cURL の例

コア統合エンドポイント#

以下の操作は、統合ガイドで使用される安定したアンカーを保持し、最も一般的な商社ワークフローのための追加コンテキストを提供します。

注文API#

注文を作成する

POST /merchants/orders

決済前に任意で注文を作成し、 order_token を返します。これは DEUNA ウィジェットと決済操作で使用されます。新しい Direct API 統合では注文を Purchase V2 にインラインで送信できます。

必要なオブジェクトは注文の種類によって異なります。チェックアウトおよび定期購入の注文には items 配列が必要ですが、航空会社の注文には航空会社の情報が必要です。基本契約では、個々のアイテムのプロパティを普遍的に必要なものとしてマークしません。を参照してください。 アイテムフィールドリファレンスと垂直フィールドガイド.

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'Content-Type: application/json' \
  --data @request.json

注文を取得

GET /merchants/orders/{order_token}

注文トークンに対応する、現在の注文、支払い、および処理状態を取得します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-merchant-id: MERCHANT_ID'

注文の支払い方法を取得

GET /merchants/orders/{order_token}/payments-methods

特定の注文と商社構成に関連する支払い方法を返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Store-Code: STORE_CODE'

支払いAPI#

支払いを作成

POST /v2/merchants/orders/purchase

推奨の 1 回呼び出しフローでインライン注文を作成して処理するか、既存の order_token を処理します。注文は別途作成されています。詳細な 支払いリクエストガイドを参照してください。.

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/purchase' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'Cookie: COOKIE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Session-Id: SESSION_ID' \
  --header 'X-Store-Code: STORE_CODE' \
  --header 'Content-Type: application/json' \
  --data @request.json

支払いをキャプチャ

POST /v2/merchants/orders/{order_token}/capture

承認された支払いをすべてまたは一部キャプチャします。接続が分離された認証とキャプチャをサポートする場合にのみ、商社バックエンドから呼び出してください。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/capture' \
  --header 'Content-Type: application/json' \
  --data @request.json

承認を無効化

POST /merchants/orders/{order_token}/void

承認を有効にします。成功した同期リクエストは、HTTP 204 No Content; 非同期のプロセッサフローは、最終的な支払いステータスに追跡する必要があります。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/orders/{order_token}/void' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data @request.json

支払いを返金

POST /v2/merchants/orders/{order_token}/refund

処理された支払いに対する完全または部分の返金を生成します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/merchants/orders/{order_token}/refund' \
  --header 'Content-Type: application/json' \
  --data @request.json

ユーザーネットワークAPI#

これらの任意操作は、顧客 ID、再利用可能な住所、安全に保存された決済手段をサポートします。非推奨ではありませんが、Purchase V2 の前提条件ではありません。Web およびモバイルアプリは顧客認証を使用します。信頼できる加盟店バックエンドは、上記の一覧で各ルートに示された認証を使用します。

認証

ユーザーを登録

POST /users/register

認証して顧客データと保存済み決済方法を安全に再利用できるユーザーを任意で作成します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/register' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

OTPをリクエスト

POST /users/request-code

パスワードレス認証フローで使用される、一時コードを送信します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/request-code' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

OTPでログイン

POST /users/login

有効な一時コードを、ユーザーの認証トークンに交換します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/login' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Qa-Api-Key: QA_API_KEY_VALUE' \
  --header 'X-Recaptcha-Token: RECAPTCHA_TOKEN_VALUE' \
  --header 'X-Session-ID: SESSION_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

外部認証

POST /users/external-authorize

商社が管理する認証フローを通じてユーザーを認証します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/external-authorize' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Auth-Message: AUTH_MESSAGE_VALUE' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

ユーザー

GET /users/me

統合で任意の顧客アカウントを使用する場合に、認証済みユーザープロフィールを返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/me' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

住所

GET /users/{user_id}/addresses

ユーザーに関連付けられた再利用可能な住所を一覧表示します。この任意操作は Purchase V2 の前に必要ありません。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID'

POST /users/{user_id}/addresses

認証済みユーザーが再利用できる住所を任意で保存します。住所は決済リクエストにインラインで指定することもできます。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

PATCH /users/{user_id}/addresses/{address_id}

既存の再利用可能な住所を更新します。一覧には、これらの任意ルートに必要な Bearer 認証と加盟店コンテキストが示されています。

cURL の例
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/addresses/{address_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Device-Id: DEVICE_ID' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

カード

カードを保存

POST /v2/users/{user_id}/cards

1枚以上のカードをトークン化し、将来の利用のために保存します。リクエストボディは、カードが1枚だけの場合もJSON配列です。ユーザーのBearerトークンと、生成されたインベントリに表示されるマーチャントコンテキストを使って、この顧客認可エンドポイントを呼び出します。

マーチャントが必要なPCI範囲を持たない限り、生のカードデータをマーチャントサーバーに通過させてはいけません。 Cards APIのヴォールティングフロー で、リクエスト形式、セキュリティ境界、成功レスポンス、再試行のガイダンスを確認してください。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/v2/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

どのカードPOSTルートを使用すべきですか?

CSVファイルのみをサポートします。 POST /v2/users/{user_id}/cards は現在の外部Cards API契約の一部です。Gatewayインベントリに表示される可能性のある他のPOSTルートは、異なる互換性やプラットフォーム目的に使用されます。これらはカードを作成するための3つの交換可能な方法ではありません。

ルート実際の機能外部統合ガイダンス
POST /v2/users/{user_id}/cards1つ以上の顧客カードをトークン化して保存します。リクエストボディは配列であり、1枚のカードを含む場合でも同様です。レスポンスは再利用可能なDEUNA card_id values.新しい顧客認証済みCards API統合にはこのルートを使用してください。
POST /users/{user_id}/cards既存の統合向けに、レガシーv1単一カードリクエスト契約を維持します。互換性ルートです。現在の外部APIカタログから意図的に除外されています。DEUNAから明示的に指示されない限り、新しい統合でこれを使用しないでください。
POST /users/{user_id}/cards/{card_id}/tokens既存のカードにプロセッサー固有のトークンまたは検証結果を追加します。顧客カードの作成や /v2 保管操作の置き換えは行いません。プラットフォーム管理操作です。外部ドキュメントから意図的に除外されており、DEUNAがフローと契約を承認しない限り、直接呼び出してはいけません。

:::info ルートがここに表示されない理由 API Gatewayインベントリには、互換性およびプラットフォーム運用ルートと、公開加盟店契約の両方が含まれます。Gatewayに存在すること自体が、その操作がサポートされる外部APIであることを意味しません。カタログには、外部リファレンスの一部であるか、所有チームからの明示的な承認がある操作のみが公開されます。 :::

保存済みカードを一覧表示する

GET /users/{user_id}/cards

認証済みユーザーに関連付けられたカードを返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID'

保存済みカードを取得する

GET /users/{user_id}/cards/{card_id}

認証済みユーザーに関連付けられた1枚のカードを返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN'

カードをデフォルトに設定する

PATCH /users/{user_id}/cards/{card_id}/set-as-default

選択した保存済みカードを認証済みユーザーのデフォルトに設定するか、その状態を解除します。カードがデフォルトになると、DEUNA はユーザーの他のカードからデフォルト状態を解除します。 カードをデフォルトに設定する で、省略可能なリクエスト本文、レスポンス、確認手順を参照してください。

cURL の例
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/users/{user_id}/cards/{card_id}/set-as-default' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

カードのBIN情報を取得

GET /cards/bin/{bin}

6桁のBINに対応する、カードネットワーク、発行者、およびカードの種類に関するメタデータを返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/cards/bin/{bin}' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID'

商社API#

Themes API

Themes APIはサポートされており、非推奨ではありません。これは、DEUNA CheckoutおよびWidgetエクスペリエンスに適用できる、名前付きの加盟店スコープJSON設定を管理します。これらの操作は、信頼できる加盟店バックエンドからのみ、プライベート X-Api-Keyを使用して呼び出してください。Checkout Configurationサービスは、その認証情報から加盟店スコープを導出します。

テーマリソース

フィールド返される作成更新説明
idはい生成されるパスパラメータDEUNAによって生成されたテーマUUID。更新および削除の theme_id として使用します。
nameはい必須オプション( config が指定されている場合)文字、数字、アンダースコアを含む、加盟店内で一意の名前。
configはい必須オプション( name が指定されている場合)CheckoutまたはWidgetエクスペリエンスによって使用されるテーマ設定を含むJSONオブジェクト。

作成操作は重複する名前を拒否し、Checkout Configurationサービスの最大テーマ数を強制します。更新および削除は、 theme_id が加盟店設定内の既存のテーマに属していない場合にエラーを返します。

curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/checkout/themes' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "checkout_default",
    "config": {
      "theme": {
        "mainColor": "#1479A8",
        "secondaryColor": "#111827",
        "backgroundColor": "#FFFFFF"
      }
    }
  }'
テーマJSON
{
  "id": "bfcabe59-48c9-4c36-b041-71597478689c",
  "name": "checkout_default",
  "config": {
    "theme": {
      "mainColor": "#1479A8",
      "secondaryColor": "#111827",
      "backgroundColor": "#FFFFFF"
    }
  }
}

一覧操作は、 data[]内で同じリソース形状を返します。作成および更新は、影響を受けたテーマを返します。削除は空のレスポンスで成功します。

:::note テーマ設定スキーマ サービスは config がJSONオブジェクトであることを検証しますが、そのネストされたキーは検証しません。テーマを使用するCheckoutまたはWidgetのバージョンでサポートされている設定形状を使用してください。Themes APIの config オブジェクトとSDKの CustomStyle オブジェクトが交換可能であると想定しないでください。 :::

支払い方法

GET /merchants/stores/payments-methods

ストアで有効な支払い方法を返します。ストアコードを必要な X-Store-Code header.

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/stores/payments-methods' \
  --header 'X-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Idempotency-Key: IDEMPOTENCY_KEY' \
  --header 'X-Merchant-Id: MERCHANT_ID' \
  --header 'X-Prediction-Id: PREDICTION_ID_VALUE' \
  --header 'X-Store-Code: STORE_CODE'

POST /merchants/payment-links

信頼できる商社側のバックエンドから支払いリンクを作成します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links' \
  --header 'Content-Type: application/json' \
  --data @request.json

GET /merchants/payment-links/{payment_link_id}

支払いリンクとその現在の状態を取得します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}'

GET /merchants/payment-links/all

認証済み加盟店のストアに関連付けられた支払いリンクを一覧表示します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/all'

GET /merchants/payment-links/{payment_link_id}/orders

支払いリンクに関連付けられた注文を一覧表示します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/merchants/payment-links/{payment_link_id}/orders'

詳細は、 支払いリンクの統合ガイド を参照してください。

サブスクリプション API#

プラン

GET /subscriptions/plans

認証された商社で利用可能なサブスクリプションプランをリストします。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

POST /subscriptions/plans

サブスクリプションプランの作成

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions/plans' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

サブスクリプション

サブスクリプションのリスト表示

GET /subscriptions

認証された加盟店に利用可能なサブスクリプションを返します。

cURL の例
curl --request GET \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID'

サブスクリプションの作成

POST /subscriptions

既存のプランと支払い方法を使用してサブスクリプションを作成します。

cURL の例
curl --request POST \
  --url 'https://api.sandbox.deuna.io/subscriptions' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json

サブスクリプションの更新

PATCH /subscriptions/{id}

アクティブなサブスクリプションのサポートされている属性を更新します。

cURL の例
curl --request PATCH \
  --url 'https://api.sandbox.deuna.io/subscriptions/{id}' \
  --header 'Authorization: Bearer USER_ACCESS_TOKEN' \
  --header 'x-Api-Key: YOUR_PRIVATE_API_KEY' \
  --header 'X-Merchant-ID: MERCHANT_ID' \
  --header 'Content-Type: application/json' \
  --data @request.json