直接API
DEUNAサーバーAPIを使用して、商人が独自の支払い体験を構築します。
DEUNAの支払いおよびチェックアウトソリューションを、Direct API/Headless経由でアプリケーションに統合します。
DEUNA APIサービスは、RESTの原則に基づいて構成されています。
これは、サービスが次のことを意味します。
- リソース指向である。
- JSON形式の応答を受信および返信する。
- 標準のHTTPステータスコードを使用する。
- REST規格に準拠した認証
- 標準的なRESTメソッド（GET, POST, PATCH, FETCH, DELETE）を使用してください。
認証#
DEUNAは、アプリケーション用のプライベートおよびパブリックなAPIキーを作成します。
APIキーを使用して、APIへの商取引者としての認証を行います。APIキーは、Sandboxアカウントの作成時に生成され、DEUNAのTPMからも提供されます。同じアカウントに関連付けて複数のAPIキーを作成できます。
JWTトークンは、決済の作成、カードの保存、およびユーザーデータの操作に使用されます。
冪等性#
DEUNAのAPIは、冪等性をサポートしており、APIへのリクエストを再試行しても、意図せず同じ操作が複数回実行されることを心配する必要がありません。
DEUNAは、各値に対して、最初のリクエストのレスポンスコードとペイロードを保存します。 idempotency key.
DEUNAは、各イデモペンシーキーの値に対して、最初のリクエストのレスポンスコードとペイロードを保存します。
Idempotency キーは、HTTP メソッド: POST に使用されます。
環境で使用#
DEUNA API環境には、互いに独立した2つの環境があります。
サンドボックス
サンドボックスは、テスト用の環境です。
サンドボックス環境には、それぞれのテスト環境をターゲットとした、さまざまな決済および不正行為防止プロバイダーへの接続が含まれています。
サンドボックス環境を使用して、各プロバイダーの利用可能なデータでテストを実施してください。
URL: https://api.sandbox.deuna.io
本番環境
プロダクション環境は、実際の取引を処理するために使用されます。
本番環境に移行する前に、必ずサンドボックス環境で各統合をテストしてください。
URL: https://api.deuna.io
Postmanコレクション#
DEUNAは、より簡単な統合とテストのために、以下のPostmanコレクションを公開しています。 DEUNA Postmanコレクション.
ユーザー管理#
DEUNAは、すべてのリソースおよびサービスをより効果的に管理および構造化するために、ユーザーの作成を許可します。
- ユーザーを作成する。
- ユーザーを取得
- ユーザーを削除
- 保存されたカードをユーザーに関連付ける
- 支払いとユーザーを関連付ける
- 住所をユーザーに関連付ける
カードを保存#
DEUNAは、以前に保存されたカードを保存し、お客様の利便性を向上させるカード保存機能を提供します。
DEUNAは、作成された各カードに対して一意のトークンを生成し、安全に保存できます。
支払い処理#
DEUNAの支払いおよび不正検知エンジンを使用して、単一の統合を通じてユーザーからの支払い処理を行います。これにより、リアルタイムでの支払い連携が可能になります。
複数の決済および不正行為防止プロバイダーとの決済処理を、異なるプロバイダー間でも一貫したレスポンス構造とエラーコードの標準化を維持しながら行う。
3DS#
DEUNAは、すべての統合で3DSフローをサポートしています。
Webhooks#
DEUNAは、注文ステータスの変更に関するアップデートをWebhook経由で送信します。
Webhookは、支払い方法からの非同期イベントの通信に使用されます。承認または拒否の結果は、この標準を使用して送信されます。
3DSなどの新しい技術により、カード取引も非同期になり、ユーザーが銀行との認証を完了し、最終的な支払いステータスを受け取るまで、注文イベントを監視することが重要になります。