メインコンテンツまでスキップ
Markdownをコピー

ポイント エラーコード

ポイントのAPIで返るエラーの一覧と、ポイント固有のエラー項目 providerCode について説明します。

OpenAPIタイプ共通のエラー仕様(HTTPステータスコードの意味、エラーレスポンスの形式、title の全一覧)はエラー仕様を参照ください。

エラーレスポンスの形式​

ポイントのAPIがエラーになった場合、RFC 9457に従ったエラー情報が返ります。
ポイントでは、共通項目に加えて providerCode が返ることがあります。

{
"title": "processing_failure",
"detail": "The point provider returned an error.",
"instance": "/point/use",
"providerCode": "E052000000"
}
キー説明例
titleエラーの内容サマリー
エラーコードとして取り扱えます
一覧は以下の表を参照ください
processing_failure
detailエラーの詳細説明
エラーメッセージとして取り扱えます
全て英文です。
The point provider returned an error.
instanceエラーが発生したエンドポイント/point/use
providerCodeポイント事業者が返却したエラーコード
ポイント事業者起因のエラー時のみ設定されます
E052000000

providerCode について​

providerCode は、ポイント事業者のAPIが返したコードを 変換せずそのまま 返す項目です。

  • コードの体系と意味は ポイント事業者ごとに異なります(例:Pontaポイントの E052000000、Vポイントの 22-101)
  • ポイント事業者がコードを返さない場合は設定されません
  • 当サービスが判定したエラー(パラメーター不正など)では設定されません

providerCode は当サービスでは意味を解釈しないため、加盟店様の処理分岐には title を使用してください。
providerCode は、お客様の画面に表示するメッセージの決定、お客様からの問い合わせ対応、ポイント事業者への調査依頼の際にご利用ください。
title ごとに返る可能性がある providerCode はtitle と providerCode の対応を参照ください。

お客様へ表示するメッセージは providerCode ごとに定められています

Pontaポイント・Vポイントでは、ポイント事業者起因のエラー時にお客様へ表示するメッセージがポイント事業者との取り決めで定められています。
事業者エラーメッセージの文言を表示してください。

コードの意味についてお問い合わせが必要な場合は、title・detail・providerCode・accessId をあわせてお問い合わせください。

ポイントのAPIで返るエラー​

ポイントのAPIで返る title の一覧です。

title名説明加盟店様の対応HTTP
ステータス
コード
missing_parameter必須パラメーターが設定されていません。
ポイント事業者ごとに必須の項目が異なります
detail の項目名を確認し、事業者別の仕様差異を参照して必須パラメーターを設定してください400
invalid_parameterリクエストパラメーターの書式・桁数が不正です。
ポイント事業者ごとに異なる形式・上限に反する場合も含みます
detail の項目名を確認して修正してください。
ポイント事業者ごとの形式・上限は事業者別の仕様差異を参照ください
400
unsupported_operation指定したポイント事業者が対象の操作に対応していません。
ポイント付与の部分取消を指定した場合も含みます
事業者別の仕様差異で対応APIを確認してください400
approval_not_foundポイント認可が存在しない、または解除されています。
指定した pointAccountReference が認可済みの内容と一致しない場合も含みます
memberId と pointAccountReference がポイント認可結果確認(/point/memberinquiry)APIで取得した値であることを確認してください。
認可が存在しない場合はポイント認可開始(/point/start)APIから認可し直してください
400
approval_terminatedポイント認可が無効、または有効期限切れです同上400
invalid_status対象の取引状態に対して処理できないリクエストです。
既に取消済み、取消できない状態、既に認可済みなどの場合に発生します
ポイント取引照会(/point/inquiry)APIで取引状態を確認してください400
transaction_not_found対象の取引が存在しませんaccessId / orderId を確認してください400
transaction_already_exists対象の取引が既に存在します。
orderId の重複も含みます
orderId を一意の値にしてください400
transaction_expired処理期限を超過しています。
ポイント利用取消・利用ポイント変更の期限超過時に発生します
元取引の処理可能期間を確認してください400
transaction_count_exceeded同一取引に対する処理上限を超過しています。
利用ポイント変更は1取引につき1回まで です
2回目以降の変更が必要な場合はポイント利用取消(/point/cancel)APIで全額取消のうえ、再度ポイント利用(/point/use)APIを実行してください400
member_not_found対象の会員が存在しませんmemberId を確認してください400
invalid_contract対象ショップの契約状態が無効、またはショップの設定が不足していますポイントのご利用契約と設定状況をご確認ください400
member_terminated対象の会員のポイント利用が停止されていますお客様にポイント利用が停止されている旨を案内してください。providerCode は対応表を参照ください400
insufficient_balanceポイント残高が不足しています。
usePoint が salesAmount を超えた場合も同じエラーが返ります
お客様に残高不足を案内してください。事前にポイント残高照会(/point/balance)APIで利用可能ポイント数を確認することで回避できます。
usePoint と salesAmount の関係は加盟店様側でご確認ください
402
operation_aborted_by_userお客様の操作によりポイント認可が中止されましたお客様に中止を案内してください402
processing_failureポイント事業者からエラーが返りました。
ポイント口座の利用停止、連携数上限の超過、付与ポイント数が付与率と整合しない場合などが含まれます
detail と providerCode を確認してください。お客様側の状態に起因する場合はお客様への案内が必要です。
付与ポイント数については事業者別の仕様差異を参照ください
402
too_many_requests同時接続数の上限を超過しています。
ポイント事業者またはポイントGWの処理上限を一時的に超過した場合も含みます
時間をおいて再実行してください429
internal_server_error当サービスのサーバーで問題が発生しました時間をおいて再実行してください。継続する場合はお問い合わせください500
bad_gatewayポイント事業者やネットワークで問題が発生しました。
ポイント事業者のタイムアウトのほか、ポイント事業者が一時的に利用できない場合も含みます
時間をおいて再実行してください。ポイント事業者が一時的に利用できない場合は、ポイント事業者へ処理が送信されていません。処理結果が不明な場合はポイント取引照会(/point/inquiry)APIで状態を確認してください502
maintenanceポイント事業者がメンテナンス中です時間をおいて再実行してください502

title と providerCode の対応​

Pontaポイント・Vポイントの、ポイント事業者起因のエラーで title ごとに返る可能性がある providerCode の一覧です。
1つの title に複数のポイント事業者・複数のコードが対応します。処理分岐は title で行い、providerCode は問い合わせ対応やお客様へのメッセージ表示にご利用ください。

titlePontaポイントVポイント
invalid_parameterE041000000—
approval_not_foundE030000000
E031000000
22
50
70
22-202
approval_terminated—40
41
42
invalid_status—22-101
transaction_not_found—15
transaction_already_existsE024000000
E040000000
05
member_not_foundE021000000
E032000000
E033000000
10
11
51
invalid_contractE02500000018
insufficient_balanceE05200000017
member_terminatedE058000000
E059000000
N058000000-02
N058000000-03
12
13
14
31
operation_aborted_by_userE154000999—
processing_failureE023000000
E068000000
E090000000
E099000000
E161000999
F501000000
F590000000
41
42
43
44
45
52
53
99
22-200
22-201
too_many_requestsE900000000—
bad_gatewayE001+6桁
E002+6桁
E003+6桁
E004+6桁
E005000000
E006000000
E007000000
E008000000
E009000000
E010000000
E067000000
E069000000
E090000000
E511000000
F502000000
04
16
23
30
90
92
maintenance—80
  • 表の title は X-MP-Version が 2026-07 の場合です。2023-05 では、approval_not_found・approval_terminated・transaction_not_found・transaction_already_exists・member_not_found は invalid_request、member_terminated は processing_failure で返ります
  • — の欄は、そのポイント事業者では該当する providerCode がないことを示します。同じ title でも、ポイント事業者がコードを返さないエラー(タイムアウト、メンテナンスなど)では providerCode は設定されません
  • 同じコード値でも、APIによって title が異なる場合があります(例:Pontaポイントの E090000000、Vポイントの 41 / 42)。providerCode だけで title を判断しないでください
  • ポイント認可の失敗はポイント認可結果確認(/point/memberinquiry)API、ポイント付与・ポイント付与取消の失敗はポイント取引照会(/point/inquiry)APIの errorInformation で返ります
  • ポイント残高照会(/point/balance)APIでは、member_terminated の行のコードはエラーではなく 200(pointUsable が false)で返ります(後述)
  • invalid_status(Vポイントの 22-101)は、通常はポイント認可済みとして成功で返り、エラーにはなりません
  • ポイント事業者の仕様変更などにより、表にないコードが返る場合があります

ポイント残高照会の特例​

ポイント残高照会(/point/balance)APIでは、ポイント事業者がお客様のポイント利用を抑止している場合(お客様が初期状態、ポイント利用停止など)も、照会自体は成立しているため 200 で返ります。

この場合はエラーレスポンスではなく、以下のように返ります。

{
"pointType": "PONTA",
"memberId": "member-001",
"availablePoint": 1400,
"pointUsable": false,
"providerCode": "N058000000-03"
}
  • pointUsable が false のときはポイント利用をお控えください
  • 残高(availablePoint)が返っていても pointUsable が false のことがあります
  • 抑止理由が判別できる場合のみ providerCode が設定されます

pointUsable が false のままポイント利用(/point/use)APIを実行しても、ポイント事業者側で拒否され processing_failure となります。 残高照会の結果でポイント利用の入力画面・機能を抑止してください。

お客様の状態の判別​

Pontaポイントでは providerCode の末尾でお客様の状態区分を判別できます。

providerCodeお客様の状態
N058000000-02初期状態(ポイント利用の申込が未実施)
N058000000-03ポイント利用停止

title と detail は両区分で共通のため、区分の判別には providerCode を使用してください。

お客様へ表示するメッセージ​

Pontaポイント・Vポイントでは、ポイント事業者が定めたメッセージをお客様へ表示する必要があります。

エラー時に加盟店様が独自に作成した文言を表示することはできません。当社が提示するメッセージ文言をそのまま表示してください。

エラー発生時のロールバック​

ポイント利用の後に実行した決済がエラーになった場合は、ポイント利用取消(/point/cancel)APIでポイント利用を取消してください。

ポイント利用APIそのものがエラーになり結果が不明な場合も、ポイント利用取消(/point/cancel)APIで取消できます。

ポイント付与が GRANTFAIL(付与失敗確定)となった場合、ポイントは付与されていないため取消は不要です。

関連情報​

🤖 LLMですか?llms.txt・llms-apis.txtに各ページの概要とリンクをまとめています。回答生成に活用してください。