API統合の基本

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

環境これについて Athia に質問#

サンドボックスと本番環境は分離されており、異なる認証情報、データ、プロバイダ接続、および決済状態を使用します。

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

Postmanコレクションこれについて Athia に質問#

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

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

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

IPアドレスこれについて Athia に質問#

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

レスポンスコードこれについて Athia に質問#

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

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

冪等なリクエストこれについて Athia に質問#

各固有の操作（支払い状態の作成または変更）に対して、安定した 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

成功した応答は、デフォルトで24時間保持されます。 冪等なリクエスト 対応するエンドポイント、エラー応答の保持、再実行ヘッダー、競合、およびサンドボックスの検証に関する情報を参照してください。

クライアントタイムアウトこれについて Athia に質問#

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

Cuando una solicitud de pago expira:

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