API統合の基本

DEUNA APIリソースを統合する前に、これらの共有設定を使用してください。 同じ環境、ネットワーク、再試行、およびタイムアウトルールは、注文、支払い、ユーザー、決済リンク、およびサブスクリプションに適用されます。

環境で使用#

サンドボックスと本番環境は分離されており、それぞれ異なる認証情報、データ、およびWebhookエンドポイントを使用します。

詳細は 認証と環境 認証情報の種類、ローテーション、およびリクエストの例について。

Postmanコレクション#

DEUNAのPostmanコレクションを使用して、クライアントを構築する前にリクエストをテストします。

PostmanでDEUNAコレクションを開く

1. Postmanにサインインし、コレクションをワークスペースにコピーします。
2. サンドボックスまたは本番環境を選択
3. 設定 merchant_id, public_api_key, および private_api_key 指定環境の値を使用します。
4. からの操作から開始します。 エンドポイント: カタログ.

IPアドレス#

ドメインの許可リストを使用することを推奨します。ネットワークポリシーがそれをサポートしている場合です。Webhook受信者または決済/不正行為プロバイダーがIPアドレスの許可リストを必要とする場合は、以下のアドレスを使用してください。

レスポンスコード#

正常な操作は、以下のいずれかのレスポンスを返します。 2xx レスポンス A 4xx レスポンスは、認証、権限、リクエストデータ、またはリソースの状態が変更される必要があることを意味します。 5xx レスポンスは、一時的なDEUNAまたはプロバイダー側のエラーを示し、操作を繰り返すことが安全な場合にのみ再試行する必要があります。

以下の 「レスポンスとエラーコードの参照」 を使用して、原因、再試行ポリシー、および適切な対処方法を特定してください。

冪等なリクエスト#

各固有の操作（支払い状態の作成または変更）に対して、安定した X-Idempotency-Key を送信してください。ネットワーク障害またはクライアントタイムアウト後に再試行する際には、同じキーと完全なリクエストボディを使用してください。新しいビジネス試行の場合は、新しいキーを使用してください。

X-Api-Key: YOUR_PRIVATE_API_KEY
X-Store-Code: STORE_CODE
X-Idempotency-Key: order_1042-attempt_1
Content-Type: application/json

詳細は 支払いを作成 購入に関する契約と、再試行の例を参照してください。

クライアントタイムアウト#

クライアントタイムアウトとは、呼び出し元が待機を停止したことを意味します。これは、決済が失敗したことを証明するものではありません。クライアントが切断した後でも、不正チェック、ルーティング、およびプロバイダーを通じて決済処理は継続できます。

Cuando una solicitud de pago expira:

1. 履行を保留し、ご自身のシステムで試行を保留中の調整としてマークしてください。
2. 注文ID、リクエストボディ、および元のイデモレンシーキーを保持してください。
3. 操作が有効な場合にのみ再試行し、同じ冪等性キーと完全なボディを使用してください。
4. 検証済みの最終状態を照合 ウェブフック または、適切な注文検索 エンドポイント: カタログ.
5. 正規化された結果を顧客に提示し、必要なキャンセルまたは払い戻しを行う前に、履行を完了します。