DEUNA API

エラーコード

すべてのエラーは、安定した、機械可読なコードを返します。エラーは、メッセージテキストではなく、コードに基づいて処理してください。

最終更新日 October 5, 2026

このページで

エラーオブジェクト
エラー参照
決済および注文エラーカタログ
エラー処理

エラーオブジェクト#

エラー応答JSON

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "message": "The payment was declined by the payment provider.",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP",
    "doc_url": "/errors#payment-declined"
  }
}

code — 分岐に使用する安定した識別子。
message — 人間が読みやすい形式で、変更される可能性があります。解析しないでください。
request_id — サポートに問い合わせる際に、必ず含めてください。

エラー参照#

HTTP 402PAYMENT_DECLINEDDeclined by the provider

説明

支払いが、決済プロバイダーによって拒否されました。

一般的な原因

十分な資金または信用枠が不足している。
エミッタはトランザクションをリスクが高いものとしてマークしました。
カードの有効期限切れまたは詳細が誤っている。

推奨されるアクション

明確なメッセージを表示し、顧客に別の支払い方法を試してもらう。確認 decline_reason 詳細については、こちらをご覧ください。

例：応答JSON

{
  "error": {
    "code": "PAYMENT_DECLINED",
    "decline_reason": "insufficient_funds",
    "request_id": "req_7Hc2LqP"
  }
}

HTTP 402CARD_EXPIREDPayment method is expired

説明

カードの有効期限が切れている。

一般的な原因

登録されたカードが更新されなかった。

推奨されるアクション

顧客にカード情報を更新するように依頼する。

例：応答JSON

{
  "error": {
    "code": "CARD_EXPIRED",
    "request_id": "req_2Pb8XwQ"
  }
}

HTTP 400INVALID_REQUESTMissing or malformed parameter

説明

必須パラメータが欠落している、または値の型または形式が正しくない。

一般的な原因

amount 整数ではなく、小数として送信された。
小文字または不明な値 currency.

推奨されるアクション

「[パラメータ名]」を修正してください。 error.param変更なしで再試行しないでください。

例：応答JSON

{
  "error": {
    "code": "INVALID_REQUEST",
    "param": "amount",
    "message": "amount must be an integer."
  }
}

HTTP 401AUTHENTICATION_FAILEDMissing or invalid API key

説明

この環境には有効なAPIキーが含まれていません。

一般的な原因

サンドボックスキーが本番環境に送信されている、またはその逆の状態になっています。
キーはローテーション中に無効化されました。
欠けています Bearer prefix.

推奨されるアクション

キーと環境を確認してください。詳細は認証.

例：応答JSON

{
  "error": {
    "code": "AUTHENTICATION_FAILED",
    "request_id": "req_9Qd1MnZ"
  }
}

HTTP 404RESOURCE_NOT_FOUNDThe object doesn’t exist

説明

指定されたIDを持つオブジェクトは、この環境には存在しません。

一般的な原因

本番環境でサンドボックスIDを使用しています。
パスに誤りがあります。

推奨されるアクション

IDと基本URLを確認してください。

例：応答JSON

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "param": "id"
  }
}

HTTP 409IDEMPOTENCY_CONFLICTKey reused with different body

説明

ある Idempotency-Key が、異なるリクエストパラメータで再利用されています。

一般的な原因

Una clave estática compartida en todos los pedidos.

推奨されるアクション

各ビジネスオペレーションに対して、1つのキーを生成します。詳細は Idempotency.

例：応答JSON

{
  "error": {
    "code": "IDEMPOTENCY_CONFLICT",
    "request_id": "req_4Tr6VbS"
  }
}

HTTP 429RATE_LIMIT_EXCEEDEDToo many requests

説明

リクエストがアクティブなレート制限を超えています。設定されたゲートウェイのルールに応じて、バケットは、商社、APIキー、ベアラートークン、ソースIPアドレス、エンドポイント、またはバックエンドサービスでスコープされます。

一般的な原因

リクエスト数を制限しないバッチ処理。
バックオフなしで再試行ループ。
複数のワーカーが独立して同じキューを解放しています。
商社またはエンドポイント固有の容量計画を超えるトラフィック。

推奨されるアクション

待機する Retry-Afterを参照してください。レート制限（ゲートウェイの範囲と、範囲の拡張をリクエストする手順）

例：応答JSON

{
  "error": "rate_limit_exceeded",
  "message": "maximum requests",
  "code": 429,
  "endpoint": "/merchants/orders",
  "total_requests": 101,
  "retry_after": "1s"
}

HTTP 503PROVIDER_UNAVAILABLENo provider could process it

説明

ルーティングパス上のすべてのプロバイダーが利用できませんでした。

一般的な原因

バックアップ設定がないプロバイダーの障害。

推奨されるアクション

同じ設定で再度試してください。 Idempotency-Keyまた、オーケストレーションにおいて、フォールバック機能を有効化します。

例：応答JSON

{
  "error": {
    "code": "PROVIDER_UNAVAILABLE",
    "routing": { "attempts": 2 }
  }
}

決済および注文エラーカタログ#

このカタログは、以前の公開された応答コード参照からの完全な安定コードセットを復元します。現在のコードは、支払いおよび注文APIのコードパスと照合されています。レガシーのみのコードは、後方互換性のためにリストされています。メッセージは異なる場合があります。コードに基づいて分岐し、メッセージテキストの解析は避けてください。

注文と決済

注文のライフサイクル、決済準備、決済リンク、ファイルおよびリクエストの処理

エラーコード	エラーの種類	原因	推奨されるアクション
`CHECKOUT-1000`	チェックアウトが準備できていない	チェックアウトを開始できません	チェックアウト設定を確認
`CHECKOUT-1001`	CheckoutNotReadyForShipping	チェックアウトが配送設定を確認できません	配送方法または配送料金の設定を確認してください。
`CHECKOUT-1002`	CheckoutNotReadyForNotify	チェックアウトが通知を送信できません	通知エンドポイントが1つだけ設定されていることを確認してください。
`EMA-1000`	必須ヘッダーが不足	リクエストヘッダーが欠落または無効	リクエストにヘッダーが正しく送信されていることを確認してください。
`EMA-1001`	メタデータ取得に失敗	メタデータの取得に失敗	リクエストで送信されたメタデータの形式が正しいか確認してください。
`EMA-1002`	PayloadError	リクエストのペイロードに問題が発生しました。	リクエストのペイロードまたは本文が正しくフォーマットされているか確認してください。
`EMA-1003`	ShippingOptionNotAvailable	配送オプションは利用できません	利用可能な配送またはピックアップオプションが有効かどうかを確認してください。
`EMA-1004`	OrderAlreadyProcessed	注文はすでに処理済みです	新しい注文を作成してください。以前の注文はすでに処理されています。
`EMA-1005`	OrderStatusNotValidForTransition	すでにキャンセル、払い戻し、または完了した取引の状態を変更しようとしている	変更を試みる前に、取引の現在の状態を確認してください。
`EMA-1006`	OrderStateConflicts	注文には有効な配送方法が設定されていません	取引を進める前に、有効な配送方法を選択してください。
`EMA-1007`	ShippingMethodNotAvailable	選択した配送方法が利用できません	商人の設定されている配送方法を確認し、互換性のあるものを選択してください。
`EMA-1008`	ConfigurationOperationConflict	Trade setup がデータベースに存在しません	必要な設定が正しく設定されていることを確認してください。
`EMA-1009`	InvalidOrderType	無効な注文タイプ	送信している注文タイプが、設定されたシステムと互換性があるか確認してください。
`EMA-2000`	CannotParseData	データ処理または分析時にエラーが発生	送信されたデータが正しい形式であり、システム要件を満たしていることを確認してください。
`EMA-3000`	ConfigurationNotFound	設定が見つかりません	商人の統合用エンドポイントが設定されていません。
`EMA-3001`	注文が見つかりません	注文が見つかりません	注文がストアに登録されていません。正しい注文であるか、またはストア内で注文されていることを確認してください。
`EMA-3002`	データベースエラー	データベースエラー	後でトランザクションを再試行してください。
`EMA-3003`	ConfigurationAlreadyExist	既存の取引設定の作成を試行しました	新しい設定を作成する前に、設定がすでに登録されていることを確認してください。
`EMA-4000`	リクエストサービスエラー	リクエストがサービスに接続できません	リクエストが正しいことを確認してください。
`EMA-4001`	RequestServiceTimeout	リクエストの応答を待つ時間が経過しました	別のリクエストを生成してください。
`EMA-4002`	ペイヤーサービスエラー	支払い方法が利用できない、または商社へのリクエストが失敗しました	支払い方法が正しく設定されていることを確認するか、サポートにお問い合わせください。
`EMA-5000`	認証エラー	リクエストが認証されていません。	リクエストヘッダーにX-API-Key が含まれていません
`EMA-5001`	無効なAPIキー	提供されたAPIキーが無効です	リクエストで使用されているAPIキーを確認し、必要に応じて有効なものに置き換えてください。
`EMA-6000`	払い戻しエラー	払い戻しが失敗しました。	リクエストのボディが正しくフォーマットされていることを確認してください。
`EMA-6001`	キャンセルエラー	キャンセルリクエストが失敗しました。	リクエストのボディが正しくフォーマットされていることを確認してください。
`EMA-6002`	保留中の支払い	注文は保留中または処理中です	注文ステータスの更新を待つか、または追加の操作を行う前に現在のステータスを確認してください。
`EMA-6003`	CaptureError	注文のキャプチャステータスへの更新を試みた際に発生するエラー	注文が存在することを確認し、キャプチャの条件を満たしていることを確認してください。
`EMA-6004`	CannotCreateOrder	注文の作成またはトークン化に失敗	注文を作成するための提供されたデータが正しいことと完全であることを確認してください。
`EMA-6005`	CannotUpdateCustomFields	注文のカスタムフィールドの検証または更新に失敗	カスタムフィールドが正しく定義され、設定されたシステムと互換性があることを確認してください。
`EMA-6006`	CannotGetUserInfo	ビジネスユーザーサービスへのリクエストが失敗	ユーザーサービスへの接続を確認し、リクエストに正しいパラメータが含まれていることを確認してください。
`EMA-6007`	CannotGetWebhook	Webhookの設定を取得できません	リクエストのボディが正しくフォーマットされていることを確認してください。
`EMA-6008`	CannotExecuteWebhook	カスタムフィールドが設定されていないWebhook応答	Webhookの設定を確認してください
`EMA-6009`	CannotApplyTemplate	テンプレートの適用時に競合が発生	設定されたテンプレートを確認してください。
`EMA-6010`	ErrorFromMerchant	商社APIのエラーにより発生したエラー	リクエストのボディが正しくフォーマットされていることを確認してください。
`EMA-6011`	CannotUpdateOrder	注文の更新に失敗	リクエストのボディが正しくフォーマットされていることを確認してください。
`EMA-6016`	CannotCancelPurchasedOrder	購入済みの注文の通知を送信およびキャンセルできない	通知設定を確認し、注文がキャンセルされる条件を満たしていることを確認してください。
`EMA-6017`	CannotNotifyPurchasedOrder	商社通知設定が利用できません	注文の通知設定を、アラートや更新を送信する前に、必ず事前に設定してください。
`EMA-6018`	認証エラー	認証に問題が発生しました。	現在使用しているAPIキーを確認してください。
`EMA-6019`	OrderExpired	この注文はすでに期限切れのため、支払うことはできません。これは、期限切れの注文で支払いを試みた場合に発生するエラーです。	新しい注文を作成する必要があります。
`EMA-6020`	CannotExpireOrder	この注文を期限切れにすることはできません。注文はすでに期限切れになっているか、関連する支払い試行が行われているためです。特別なケース：PIX：関連する支払い試行がない場合、または支払い試行が保留中の場合は、注文を期限切れにできます。	新しい注文を作成する必要があります。
`EMA-6021`	CannotCreatePaymentLinkTemplate	決済リンクテンプレートの作成に失敗しました。	支払いリンクリクエストに含まれるフィールドが、作成に必要なものであることを確認してください。
`EMA-6022`	CannotGetPaymentLinkTemplate	要求された支払いリンクテンプレートが見つかりません。	要求された支払いリンクIDを確認してください。
`EMA-6023`	CannotUpdatePaymentLinkTemplate	支払いリンクテンプレートの更新中にエラーが発生しました。	支払いリンクを更新するために必要なフィールドを確認してください。
`EMA-6024`	InvalidStatusTransitionPaymentLinkTemplate	要求されたステータス遷移が無効であるか、変更が許可されていません。	ステータスを変更または変更する前に、ステータスが変更または変更可能であることを確認してください。
`EMA-6025`	PaymentLinkTemplateExpired	支払いリンクテンプレートが期限切れとなり、使用できなくなりました。	必要に応じて新しい支払いリンクを生成するか、現在の支払いリンクの期限切れ日を変更してください。
`EMA-6026`	PaymentLinkTemplateLimitExceeded	支払いリンクの最大使用回数が上限に達しました。	新しい支払いリンクを作成するか、リデンプション制限を増やしてください。
`EMA-6027`	PaymentLinkTemplateCompleted	支払いリンクテンプレートが完了しました。	追加の操作は不要です。新しい支払いが必要な場合は、新しいリンクを生成してください。
`EMA-6028`	PaymentLinkTemplateDisabled	支払いリンクテンプレートが無効になり、利用できなくなりました。	リンク設定を確認し、必要に応じてリンクを再アクティブ化するか、新しいリンクを作成してください。
`EMA-6029`	PaymentLinkTemplateCancelled	決済リンクのテンプレートが無効化されています。操作は続行できません。	新しいトランザクションが必要な場合は、新しい決済リンクを作成してください。
`EMA-7000`	InvalidFileRequest	ファイルリクエストが無効です	送信する前に、リクエストに正しいパラメータが含まれていることを確認してください。
`EMA-7001`	InternalErrorRetrievingFiles	保存されたファイルの復元時にエラーが発生	適切な復元が保証されていることを確認するために、ストレージサービスまたは設定を確認してください。
`EMA-7002`	InternalErrorRetrievingPresignedURL	事前署名されたURLの取得に失敗	事前署名されたURLの生成設定を確認し、ストレージシステムが正常に動作していることを確認してください。
`EMA-8000`	PaymentLinkRedirectError	決済リンクの注文トークへのリダイレクトに失敗	注文トークを確認し、それが正しいことを確認してください。
`EMA-9001`	AttemptsExceededCode	トランザクションに対する試行回数が上限を超えました	別のカードまたは支払い方法で再度試してください
`EMA-9998`	MerchantInternalError	内部エラー	トランザクションを再試行するか、別の決済プロバイダーを使用してください
`EMA-9999`	MerchantUnknown	リクエストに商人の識別子が含まれていません	リクエストに商人の識別子を含めるか、送信されているデータの構造を確認してください。

決済

決済の検証、処理、認証、トランザクション操作、およびプロバイダーからの応答。

エラーコード	エラーの種類	原因	推奨されるアクション
`DP-3000`	ErrPayload	リクエストに送信されたペイロードにエラーがあるか、空である	ペイロードを送信していることを確認してください。Nequiの場合は、電話番号が含まれていることを確認してください。返金トランザクションの場合は、送信された金額が正であることを確認してください。
`DP-3001`	ErrInvalidFormat	リクエストには、無効な形式、不正なフィールド、無効なデータ構造、またはサポートされていないフィールド値が含まれています。	リトライ前に、リクエストペイロード、フィールド形式、および必要なデータを修正してください。
`DP-3002`	ErrRequestServiceError	カードのトークン化または取得に失敗しました。支払いプランに関するエラー。	リクエスト情報を検証し、再度試してください。
`DP-3003`	ErrAmountRequestError	決済プロセッサは部分的な払い戻しをサポートしていません。	リクエスト内の金額フィールドが有効であるか、空でないことを確認してください。
`DP-3004`	ErrCustomerCancelled	顧客が支払いを完了する前にキャンセルしました。	店舗側での対応は不要です。カード保持者が支払いをキャンセルしました。ユーザーが新しい支払い試行を開始する必要があります。
`DP-4000`	ErrMissingHeaders	リクエストヘッダーが見つかりません。	リクエストにヘッダーが正しく送信されていることを確認してください。
`DP-4001`	ErrUnauthorized	リクエストが認証されていません。	X-API-Keyヘッダーを検証するか、設定を確認してください。
`DP-4002`	ErrCardTokenForbidden	利用不可のカード	同じカードで再試行しないでください。カード保持者は、発行銀行に連絡して制限を解除する必要があります。制限がDEUNAの不正利用ルールによるものである場合は、不正利用管理パネルでカードを確認してください。
`DP-4003`	ErrStoreCodeValidation	コードが見つかりません。	ストアコードが空でないか、正しいことを確認してください。
`DP-4004`	ErrValidation	承認および決済機能が無効です。PlacetoPayの場合、country_isoフィールドが欠落しています。	設定を確認するか、country_isoフィールドが空でないことを確認してください。
`DP-4005`	ErrMerchantIDValidation	店舗コードが見つかりません。	店舗コードが空でないか、正しいことを確認してください。
`DP-4006`	ErrUserValidation	webhookのリクエスト内のユーザー情報が空または無効です。	ユーザー情報を確認してください。
`DP-4007`	ErrParseUuid	エラートークンの形式が正しくありません。	エラートークンを検証してください
`DP-4008`	ErrCardNotFound	トークンまたはカード番号からカード情報を取得できません。	カード番号またはカードトークンを確認してください。カードIDを使用している場合、このエラーは、作成している `/purchase` に関連付けられていないカードIDであることを意味します。
`DP-4009`	ErrProcessorNotFound	決済プロセッサが存在しない、または商社向けに有効になっていません。	管理画面で決済方法が設定されているか確認してください。
`DP-4011`	ErrMerchantStoreConfigNotFound	商社ストアの設定が見つかりません。	ストアコードが正しいことを確認してください。
`DP-4012`	ErrAlreadyExistsInDB	決済または設定プロセッサがデータベースに既に存在します。	新しいレコードを追加する前に、データを検証してください。
`DP-4013`	ErrPaymentProcessorNotFound	決済プロセッサが見つかりません。	プロセッサのデータを確認し、識別子が有効であることを確認してください。
`DP-4015`	ErrProcessorNotSupported	決済プロセッサが操作をサポートしていません。	使用しているプロセッサが、要求されたメソッドをサポートしていることを確認してください。
`DP-4016`	ErrCannotFindOperations	プロセッサが要求された操作をサポートしていません。	必要な操作との互換性を確認するために、プロセッサの機能をレビューしてください。
`DP-4017`	ErrInvalidCard	提供されたカードに問題があります。	カードの詳細が正しいこと、および使用可能であることを確認してください。
`DP-4018`	ErrInvalidCaptureAmount	承認された金額よりも大きい金額のキャプチャを試行	キャプチャする金額が、元の承認額を超えないようにしてください。
`DP-4019`	ErrTransactionInProcess	トランザクションが処理中	別の操作を試す前に、現在のトランザクションが完了するまで待ってください。
`DP-4020`	ErrTokenTransactionNotFoundRedis	トランザクション情報の取得に失敗	要求された情報が存在することを確認してください。
`DP-4022`	ErrProcessorsNotSupportSplit	分割決済をサポートするプロセッサは存在しません。	プロセッサの設定を確認し、少なくとも1つが分割決済をサポートしていることを確認してください。
`DP-4023`	ErrMissingRecipientProcessors	プロセッサが欠落しているか、受信者とプロセッサの数が一致しません。	オペレーションを完了するために必要なすべての受信者とプロセッサを設定してください。
`DP-4024`	ErrInvalidCredentials	購入トランザクション、認証などでの不正な認証情報。	入力したプロセッサの認証情報が有効であることを確認してください。
`DP-4026`	ErrPurchase	購入トランザクションの失敗	トランザクションの詳細を確認し、システムが正しく設定されていることを確認してください。
`DP-4027`	ErrAuthorize	認証トランザクションの失敗	顧客情報が正しいこと、およびシステムが認証方法をサポートしていることを確認してください。
`DP-4028`	ErrCapture	キャプチャトランザクションの失敗	キャプチャする金額が有効であり、システムがキャプチャ操作をサポートしていることを確認してください。
`DP-4029`	ErrVoid	トランザクションの無効化の失敗	トランザクションが認証され、システムポリシーに従って無効化できることを確認してください。
`DP-4030`	ErrAuthenticationMissing	トランザクションに必要な書類または書類の種類が不足しています。	支払者の書類番号または種類をご提供ください。
`DP-4031`	ErrNoProcessorForDynamicRouting	動的ルーティングに関するルールが見つかりません。	要求を正しく処理するために、適切な動的ルーティングルールを設定してください。
`DP-4033`	ErrVerifyOTP	OTPコードの検証に失敗	支払人の宛にOTPコードを再送信するか、有効期限切れの古いコードを新しいものにリクエストしてください。
`DP-4034`	ErrWalletPayCredentialNotFound	ウォレット支払い方法の認証情報が見つかりません	支払人が認証情報を正しく設定していることを確認してください。
`DP-4035`	ErrInstallmentPlan	分割払いプランが生成されませんでした	分割払いプランを有効にするには、顧客データとシステム設定が正しいことを確認してください。
`DP-4043`	ErrCurrencyMismatch	通貨の不一致により、有効なプロセッサが利用できません。	リクエストを再試行する前に、要求された通貨が商人の設定済み支払いプロセッサのいずれかによってサポートされていることを確認してください。
`DP-4100`	ErrMissingCVV	セキュリティコード（CVV）の入力に失敗	トランザクションを完了するために、支払人にCVVコードを提供するように依頼してください。
`DP-4101`	ErrInvalidCVV	CVVは無効です	カード上のCVVが正しくありません。有効なCVVを入力してください。
`DP-4102`	ErrInvalidInstallments	無効な分割払い番号	利用可能な分割払いオプションを確認し、提供者が提供するものと一致していることを確認してください。
`DP-4103`	ErrInvalidTransactionAmount	トランザクション金額のエラー	入力された金額が正しいこと、および許可されている制限内であることを確認してください。
`DP-4104`	ErrInstallmentsNotSupported	プロバイダは分割払いプランをサポートしていません	分割払いプランをサポートする支払いプロセッサを使用するか、別の支払いプロセッサを使用してください。
`DP-4105`	ErrInstallmentsNotInstantiated	分割払いプランの作成に失敗	支払いプロセッサが分割払いプランを作成できること、および必要なデータがすべて揃っていることを確認してください。
`DP-4200`	ErrInternalServerErrorPSP	プロセッサから内部エラーが返されました	トランザクションを再試行するか、別の決済プロバイダーを使用してください
`DP-4210`	ErrGooglePayMessageExpired	確認メッセージが期限切れ	お客様に決済プロセスを再試行するよう促します。
`DP-4211`	ErrGooglePayInvalidSignature	決済プロセスにおける無効な署名	再度処理する前に、お客様と決済の詳細が正しいことを確認してください。
`DP-4300`	ErrExpCard	有効期限エラー	カードの有効期限を検証してください
`DP-4301`	ErrIDUser	身分証明番号/種類のエラー	支払者の身分証明番号または種類を検証してください。
`DP-4302`	ErrNameUser	カード保持者の名前エラー	カード保持者の名前を検証してください
`DP-4303`	ErrNumberCard	カード番号エラー	カード番号を検証してください。
`DP-4400`	ErrProcessing3DS	3DSウィンドウを開始できません	別のカードまたは支払い方法で再度試してください
`DP-4500`	GenericUnclassifiedError	詳細が不足しており、根本原因が発行者、PSP、ネットワーク、または検証に関連するかどうかを判断できない一般的なエラー応答。	トランザクションログとPSPの生の応答を確認してください。信頼できるサブ分類ができない場合は、このコードのみを使用してください。
`DP-4501`	発行者に連絡	発行者は、カード保持者に銀行に電話して、取引を進める前に連絡するように要求します。発行者は、カード保持者からの直接確認が必要であることを示す参照応答を返します。	お客様に、カードの裏面に記載されている電話番号に電話するように伝えてください。自動再試行は行わないでください。明示的な顧客の操作なしには、再試行できないものとして扱ってください。
`DP-4502`	TransactionNotPermitted	取引または決済方法は、発行者またはネットワークのルールに基づいて、このカード、顧客、商社、端末、またはチャネルで許可されていません。	同じカードで再度試行しないでください。カードの支払いチャネルと方法の制限を確認してください。顧客に別のカードを使用するように依頼するか、銀行に問い合わせて、承認される取引の種類を確認してもらうように依頼してください。
`DP-4504`	IssuerOrNetworkUnavailable	発行元、ネットワークスイッチ、または承認サービスが一時的に利用できない、オフライン、または処理用に初期化されていません。	これは一時的な状態です。短い時間後に再度試行してください。エラーが複数回発生する場合は、顧客に通知し、後で再度試行するか、別の支払い方法を使用することを提案してください。
`DP-4507`	InvalidPinOrPassword	カード保持者がカードの検証中に間違ったPINまたはパスワードを入力しました。PINまたは暗号化されたカード保持者検証値が発行元の記録と一致しません。	カード保持者にPINを慎重に入力するように依頼してください。これはロックアウト状態ではありません。カード保持者は残りの試行回数を使用できます（DP-9001を参照）。カード保持者がPINを忘れた場合は、発行元の銀行に連絡してください。
`DP-4510`	部分承認	発行元は要求された取引金額の一部のみを承認し、全額を承認できないことを示しています。	承認された部分の金額のみを決済してください。残高を別の支払い方法で支払うように顧客に依頼してください。元の全額で再度試行しないでください。
`DP-4511`	特別な承認	発行元またはネットワークが、V.I.P.例外処理などの特別なまたは標準外の承認条件の下で取引を承認しました。	承認された取引を処理し、照合用に記録してください。特別な承認が予期せず発生する場合は、発行元に確認してください。
`DP-4520`	ClosedOrFrozenAccount	カードに関連付けられた銀行口座が閉じられていたり、凍結されていたり、一時停止されていたり、またはブロックされており、新しい取引を受け入れることができません。	これは永続的な状態です。顧客に通知し、別のカードまたは支払い方法を使用するように依頼してください。顧客は銀行に連絡して、アカウントの状態を解決する必要があります。再度試行しないでください。
`DP-4521`	ReferralOrAuthorizationReview	この取引には、参照、STIP/フォールバックスタンドイン承認、または最終的な承認または拒否を行う前に、追加の暗号化と承認のレビューが必要です。	PSP が示す参照プロセスに従ってください。STIP の場合は、適切な代替認証ロジックを適用してください。暗号の検証は、発行者の検証フローを経由する必要があります。
`DP-4529`	InvalidOrUnsupportedAccountType	ソースまたは宛先の銀行口座が無効、存在しない、または要求された操作をサポートしていません。たとえば、口座の種類（普通預金 vs. 貯蓄）が正しくない、または口座番号が見つかりません。	口座の種類と番号を検証します。顧客に口座の詳細を確認または正しい口座の種類を選択するように依頼してください。エラーが解決しない場合は、顧客に銀行に連絡するように依頼してください。
`DP-4547`	InternationalTransactionRestriction	カードは国際取引を許可していません、または取引が、発行者の許可されていない状況で国内カードを使用して行われたため拒否されました。	顧客に国際取引を許可するカードを使用するように依頼するか、国際利用を有効にするために発行銀行に連絡するようにアドバイスしてください。同じカードでの再試行は行わないでください。
`DP-4548`	CreditDebitFunctionMismatch	取引が、カードの種類に誤った決済機能を使用して送信されました。たとえば、デビットカードに対してクレジット機能が使用された、またはその逆です。	PSP からの応答に基づいて、正しい機能（クレジットまたはデビット）を選択して取引を再試行してください。顧客は、インタラクションの際に正しいカードの種類を明示的に選択する必要がある場合があります。
`DP-4550`	HsmKeyOrCryptographicModuleError	PSP のハードウェアセキュリティモジュール (HSM) または暗号化キーモジュールが、取引の安全な処理を妨げる内部エラーを報告しました。	これは PSP のインフラストラクチャの問題であり、カードホルダーの誤りではありません。すぐに再試行しないでください。再発する場合は、PSP の技術チームにエスカレーションしてください。
`DP-4551`	EmvCryptogramOrChipValidationFailed	EMV チップデータ、取引の暗号、またはチップに関連するフィールド（ATC、CVR、TVR）の検証が、PSP または発行者レベルで失敗しました。	顧客にチップ取引を再試行するように依頼してください。エラーが解決しない場合は、代替の支払い方法を要求してください。この問題は、チップの欠陥またはターミナルとのカードの互換性の問題を示している可能性があります。
`DP-4552`	PinBlockOrPasswordEncryptionError	PIN のフォーマットが無効、カード保持者の PIN の暗号化が正しくない、または PSP の暗号化インフラストラクチャによって PIN が検証できません。	これはカード保持者ではなく、ターミナルまたは統合設定の問題です。PSPとのPINブロック形式の互換性を確認し、暗号化キーが正しく同期されていることを確認してください。
`DP-4562`	OperationDeadlineExceeded	要求された操作（決済、払い戻し、またはキャンセル）が、許可された時間枠内または承認または取引の期限が経過した後に行われました。	期限切れの操作は再試行しないでください。承認ウィンドウが閉じている後に送信された決済の場合、新しい承認が必要です。PSPとの期限および決済ウィンドウポリシーを確認してください。
`DP-5001`	ErrNotImplemented	決済方法が設定されていません	決済方法の設定を確認してください。
`DP-5002`	ErrDB	トランザクションが見つからなかったか、データベース接続に問題が発生しました	トランザクションIDを確認し、後で再度試してください。
`DP-5003`	ErrDynamicRouting	動的ルーティングサービスへのリクエストが失敗しました	ルーティング設定を確認し、ルールが正しいことを確認してください。
`DP-5004`	ErrFraudEvaluate	トランザクションの不正行為評価が失敗した可能性があり、これはパラメータが不足していることが原因です	プロセッサに要求されているパラメータを確認してください
`DP-5005`	ErrReview	トランザクションレビューの失敗	トランザクションデータが正しいことを確認してください。
`DP-5006`	ErrInitialGateway	新しいゲートウェイの開始に失敗	ゲートウェイの設定が正しいこと、および使用可能であることを確認してください。
`DP-6000`	ErrRequestAlreadyProcessed	リクエストはすでに処理されています。	このリクエストは再試行しないでください。トランザクションはすでに処理されています。元の参照IDを使用して既存のトランザクションを検索し、結果を確認してください。
`DP-6001`	ErrCannotUpdateTransaction	トランザクションの更新に失敗	トランザクションの更新を再試行
`DP-6002`	ErrCannotFindTransaction	トランザクションが見つかりません	トランザクションIDを検証し、再試行してください。
`DP-6003`	ErrUnknownPayment	トランザクションが承認されていない可能性があります	別のトランザクションを試すか、別の決済プロバイダーを使用してください
`DP-6004`	ErrCannotFindOrCreateTransaction	トランザクションが見つからないか、作成できませんでした。	別のトランザクションを試すか、別の決済プロバイダーを使用してください
`DP-6005`	ErrDuplicateRefund	トランザクションはすでに拒否または返金されています	返金を行う前に、トランザクションの現在のステータスを確認してください。
`DP-6006`	ErrUnknownVoid	トランザクションはすでに拒否または無効になっています	返金を行う前に、トランザクションの現在のステータスを確認してください。
`DP-6007`	ErrUnknownCapture	トランザクションのキャプチャに失敗	返金を行う前に、トランザクションの現在のステータスを確認してください。
`DP-6008`	ErrRefund	返金処理の失敗	プロバイダーから返金失敗の理由を確認してください。
`DP-6009`	ErrCannotUpdatePartialRefund	部分返金の更新に失敗	部分返金パラメータが正しいこと、およびプロバイダーがサポートしていることを確認してください。
`DP-6010`	ErrCannotFindPartialRefund	部分返金が見つかりません	データを確認し、再度試してください
`DP-6011`	ErrOperationDisabled	決済プロバイダーの設定では、この操作が許可されていません。または、カードホルダーまたは発行者によって、定期/サブスクリプション決済サービスが一時停止されています。	別の操作を試すか、別の決済プロバイダーを使用してください
`DP-7000`	ErrCreditCardDisabled	クレジットカードが無効になっています。	カード保持者は、カードの再アクティベートまたはブロック解除のために、発行銀行に連絡する必要があります。ブロックが解決されるまで、同じカードでの再試行は行わないでください。
`DP-7011`	ErrWaitingOTP	トランザクションは、OTPコードの入力を待っています。	トランザクションを完了するには、OTPコードを受信してください。
`DP-7012`	ErrFailureOTP	送信されたOTPコードが無効です。	コードを確認し、再度試すか、新しいコードをリクエストしてください。
`DP-7022`	ErrCardVault	カード番号を取得できません、または無効、または不正利用リストに登録されています。	別のカードまたはトークンを使用してください。
`DP-7023`	ErrSistecreditoPayment	SISCREDITOを使用した決済が失敗しました	情報を確認し、新しい決済を試してください。
`DP-7024`	ErrUserNotFoundOrInvalid	無効または存在しないユーザーデータ (例: 電話番号など)	ユーザーデータの形式を確認し、システム内にユーザーが存在することを確認してください。
`DP-7100`	ErrWorkflowPurchase	パラメータが不足しているため、トランザクションの作成またはカードのトークン化時にエラーが発生しました。	ペイロードに必要なフィールドを確認してください。
`DP-7101`	ErrWorkflowAuthorize	認証トランザクションの実行中にエラーが発生しました	トランザクションの詳細が正しいことを確認し、トランザクションを再試行してください。
`DP-7102`	ErrWorkflowCapture	キャプチャトランザクションの実行中にエラーが発生しました	キャプチャを実行する前に、資金が承認されていることを確認してください。
`DP-7103`	ErrWorkflowVoid	キャンセルトランザクションの実行中にエラーが発生しました	キャンセルが可能なトランザクションであることを確認し、プロセッサの詳細を確認してください。
`DP-7104`	ErrWorkflowRefund	返金処理時のエラー	返金パラメータが正しいことを確認してください。
`DP-7105`	ErrWorkflowGetTransation	トランザクションの取得または確認時のエラー	トランザクションIDが有効であることを確認し、プロセッサが利用可能であることを確認してください。
`DP-7106`	ErrWorkflowBankList	銀行リストの取得時のエラー	プロセッササービスが正常に動作していることを確認し、操作を再試行してください。
`DP-7107`	ErrSettlementValidation	トランザクションが決済プロセス中に、キャプチャ、キャンセル、返金は実行できません。	決済プロセスが完了するまで待つか、非同期v2を使用して決済を実行し、決済完了後に目的の決済を実行してください。
`DP-7108`	ErrWorkflowInstallmentPlan	分割払いプランの作成時のエラー	支払いプロセッサが分割払いに対応していること、およびパラメータが有効であることを確認してください。
`DP-7109`	ErrWorkflowCancelOrder	注文のキャンセル時の失敗	注文がキャンセル可能であることを確認してください。
`DP-7110`	ErrWorkflowReversal	返金操作の完了時のエラー	リクエストが正しくフォーマットされており、元のトランザクションが返金可能であることを確認してください。
`DP-7111`	ErrExpiredCard	カードが期限切れであり、トランザクションの完了に使用できません。	カードの有効期限が正しいことを確認するか、再試行する前に別のカードを使用してください。
`DP-8000`	ErrCannotGenerateQR	QRコードの生成ができません	QRコードを作成するためのパラメータが正しいこと、および完全であることを検証してください。
`DP-8001`	ErrFraudValidation	プロセッサから、不正行為の可能性を示すエラーが返されました。	プロセッサに要求されているパラメータを確認してください
`DP-8002`	ErrFraudSystemConn	不正検知システムが利用できないか、不正評価モジュールへの接続に失敗しました。	少時間後にトランザクションを再試行してください。不正検知システムへの接続が維持されない場合は、PSPの不正サービスステータスを確認し、統合接続を確認してください。
`DP-9000`	ErrInsufficientFunds => ErrT1PagosRefund	アカウントに十分な残高がないため、操作が完了しません。	アカウントの残高を確認し、再度お試しください。
`DP-9001`	ErrMaxAttemps => ErrT1PagosVoid	操作の試行回数または許可された金額の制限に達しました。	同じカードとPINで再試行しないでください。カード保持者は、銀行に連絡してPINを無効化するか、別の支払い方法を使用してください。
`DP-9999`	ErrUnknown	一般的なエラー	不明なエラーが発生しました。新しいリクエストを作成するか、サポートにお問い合わせください。
`DP-10000`	ErrContextCanceled	操作は、タイムアウトまたは実行コンテキストの終了によりキャンセルされました。	タイムアウト設定を確認し、ワークロードのパフォーマンスを最適化し、一時的な問題に対する再試行ロジックを設定してください。
`DP-10001`	Err3DSVerifySupport	3DS関連データの処理に問題が発生しました	提出された情報が完全かつ正しいことを確認してください。設定が最新であることを確認してください。
`DP-10002`	PayerAuthenticationRequiredOrFailed	強力な顧客認証または支払者認証が要求され、回避された、利用できない、または失敗しました。	認証可能なフローを使用して再試行するか、認証設定を確認してください。
`DP-10003`	Err3DSRequiredChallenge	3DSチャレンジエラー	別のカードまたは支払い方法で再度お試しください。
`DP-10004`	Err3DSGetStatus	3DSステータスの確認エラー	別のカードまたは支払い方法で再度お試しください。
`DP-10005`	Err3DSPurchase	3DSでの決済時のエラー	別のカードまたは支払い方法で再度お試しください。
`DP-10024`	手動レビュー	トランザクションの手動レビューステータスの取得エラー	トランザクション情報を確認してください。
`DP-10025`	Err3DSChallengeFailed	3DSチャレンジで、決済サービスプロバイダーが失敗を返却	別のカードまたは支払い方法で再度お試しください。
`DP-11000`	ErrRequestTimeout	リクエストが最大許可時間を超過し、応答を受信する前にタイムアウトしました。	リクエストタイムアウトの閾値を増やし、ターゲットサービスが応答するようにし、リクエストペイロードまたはロジックを最適化して、レイテンシを削減してください。
`DPEC-000`	PaymentMessage000	トランザクションの完了時に、コンテンツレスポンスが失敗	トランザクションの詳細が正しいこと、およびプロセッサとの通信に問題がないことを確認してください。

商人の注文応答

商人の注文、履行、クーポン応答の検証エラー

エラーコード	エラーの種類	原因	推奨されるアクション
`EM-1000`	WithoutPaymentError	OTPコードの検証に失敗	OTPコードが有効であることを確認し、操作を再試行してください。
`EM-1001`	WithoutOrderIdError	注文IDがありません	リクエストに有効な注文IDを提供し、空でないことを確認してください。
`EM-1002`	OrderNotExist	注文が存在しません	注文IDを確認し、システムに登録されていることを確認してください。
`EM-1003`	WithoutPaymentMethodError	支払い方法がありません	トランザクションを完了するために、有効な支払い方法を設定してください。
`EM-1004`	OrderWithoutPaymentMethod	注文に支払い方法が割り当てられていません	手順を進める前に、注文に支払い方法が関連付けられていることを確認してください。
`EM-1005`	PaymentNotConfigured	支払い方法が設定されていません	支払い方法が有効で正しく設定されていることを確認してください。
`EM-1006`	OrderWithoutStoreCode	注文は存在しますが、関連する店舗が割り当てられていません。	トランザクションを続行するために、適切な店舗コードを提供してください。
`EM-2000`	WithoutOrdenToken	価格計算時に注文トークンが不足しています。	有効なトークンを提供し、操作を再試行してください。
`EM-2001`	MissingParameters	配送計算のリクエストに必要なパラメータが不足しています。	リクエストを送信する前に、必要なパラメータを確認し、完了させてください。
`EM-3000`	処理できません	トランザクションのキャンセルに失敗しました。	再度試す前に、トランザクションデータを確認してください。
`EM-4000`	WithoutCoverage	配送先がカバー範囲外です。	配送方法の緯度と経度を確認し、カバー範囲内にあることを確認してください。
`EM-4001`	ClosedStore	店舗が閉鎖されています。	店舗の営業時間を確認し、営業中であることを確認してください。
`EM-4002`	OutOfStock	要求された商品は在庫にありません。	在庫レベルを確認し、システムで製品の可用性を調整してください。
`EM-5000`	MerchantUnknown	不明なエラー	不明な商社側のエラー。リクエストを再試行してください。問題が解決しない場合は、詳細なエラー情報を添えてサポートにお問い合わせください。
`EM-6000`	CuponNotFound	クーポンが見つかりません。	クーポンコードが有効な形式であることを確認し、再度試してください。
`EM-6001`	CuponNotApplicable	クーポンは期限切れ、または存在しません。	確認してください。クーポンコードが有効であり、期限切れではなく、現在使用可能であることを確認してください。
`EM-6002`	CuponAlreadyUsed	このクーポンはすでに使用されています	クーポンが使用回数制限があるか、またはユニークなクーポンであるかを確認してください。
`EM-6003`	CuponAlreadyUsedInOrder	このクーポンは注文に適用されています	注文トークンを使用して、クーポンがすでに注文に適用されているかどうかを確認してください。
`EM-9998`	MerchantInternalError	内部での取引エラー	内部エラーが発生しました。再度リクエストをお試しください。
`EM-9999`	MerchantUnknown	リクエストに商人の識別子が含まれていません	リクエストに商人の識別子を含めるか、送信されるデータの構造を確認してください。

不正行為対策

支払いおよび注文操作における安定した不正行為評価エラー

エラーコード	エラーの種類	原因	推奨されるアクション
`FRD-7000`	FraudCodeScoreAndWorkflow	トランザクションの不正行為評価に失敗しました。スコアが最大スコアを超えており、ワークフローによってトランザクションが停止されました	トランザクションを再試行するか、別の支払い方法をお試しください

エラー処理#

条件分岐 error.code; ログ request_id.
再試行 5xx および 429 バックオフ機能と、同じ設定 Idempotency-Key.
永不重試 400, 401 または 402 unchanged.

エラーオブジェクトこれについて Athia に質問#

エラー参照これについて Athia に質問#

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

説明

一般的な原因

推奨されるアクション

決済および注文エラーカタログこれについて Athia に質問#

注文と決済

決済

商人の注文応答

不正行為対策

エラー処理これについて Athia に質問#

エラーオブジェクト#

エラー参照#

決済および注文エラーカタログ#

エラー処理#