アトカラ取引登録 開発ガイド
実装方法
以下の2つのJavaScript SDKを加盟店様の購入画面に読み込み、実装する必要があります。
gmoAuthOrderDecisionを呼び出すことで決済処理が開始されます。必要なリクエスト項目は以下のセクションで説明します。
アトカラ取引登録用のJavaScript
| 環境 | URL |
|---|---|
| 検証用 | https://cdn.stg.atokara.jp/sms/js/gmoSmsCertification.js |
| 本番用 | https://cdn.atokara.jp/sms/js/gmoSmsCertification.js |
デバイス情報取得用のJavaScript
| 環境 | URL |
|---|---|
| 検証用 | https://cdn.stg.credit.gmo-ab.com/psdatacollector.js |
| 本番用 | https://cdn.credit.gmo-ab.com/psdatacollector.js |
実装サンプル
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width">
<script type="text/javascript" src="https://cdn.atokara.jp/sms/js/gmoSmsCertification.js"></script>
<script type="text/javascript">
// 注文確定ボタン押下時
function kakutei() {
if (typeof gmoAuthOrderDecision == "function") {
gmoAuthOrderDecision();
} else {
// 読み込みエラー発生時の処理
}
}
// SMS 認証結果
function gmoSmsAuthResult(data) {
// レスポンス結果判定処理
}
</script>
</head>
<form>
<!----------------------------------------------------------------------
// アトカラ取引登録に必要な情報格納されたタグにclassを付与
// 必要な項目の情報は、後述の「リクエスト」を参照
//
// (例)購入者情報の購入者氏名(漢字)の場合
// input type は、hidden やテキストを想定
// <input type="hidden" class="gmoFullName">
// <input type="text" class="gmoFullName">
------------------------------------------------------------------------>
<!-- デバイス情報 -->
<input type="hidden" id="fraudbuster" name="fraudbuster" class="gmoDeviceInfo">
<script type="text/javascript" src="https://cdn.credit.gmo-ab.com/psdatacollector.js"></script>
<input type="button" value="注文確定" onClick="kakutei();">
</form>
リクエスト
アトカラ取引登録のリクエスト項目は以下のとおりです。
画面にて各クラスに値を埋め込んでください。
input type="text" または type="hidden" を想定しています。
任意項目でもデータが存在する場合は、値をセットしてください。
認証情報
| パラメータ | 必須 | 制限 | 説明 |
|---|---|---|---|
gmoAuthenticationId | ✔ | 半角英数 10桁固定 | 認証ID アトカラ接続に必要な認証ID |
gmoShopCode | ✔ | 半角英数 11桁固定 | 加盟店コード アトカラの加盟店を一意にするコード |
gmoShopId | - | 半角英数 13桁固定 | マルペイショップID マルペイの加盟店を一意に特定するID。テスト環境では必須 |
gmoSmsPassword | ✔ | 半角英数 64桁固定 | SMS認証用パスワード SMS認証を利用する際のパスワード |
gmoHttpHeader | - | 全半角 10000桁 | HTTPヘッダ情報 詳細は端末識別情報についてを参照してください |
gmoDeviceInfo | - | 全半角 10000桁 | デバイス情報 詳細は端末識別情報についてを参照してください |
購入者情報
| パラメータ | 必須 | 制限 | 説明 |
|---|---|---|---|
orderId | ✔ | 半角英数記号 27桁 | オーダーID 加盟店が付与する取引IDです |
gmoShopOrderDate | ✔ | 日付10桁固定 (YYYY/MM/DD) | 購入者情報_加盟店注文日 お客様が商品を注文した日です |
gmoFullName | ✔ | 全半角 21桁 | 購入者情報_氏名(漢字) 半角文字は全角文字に変換します |
gmoFullKanaName | - | 全半角 25桁 | 購入者情報_氏名(カナ) 半角文字は全角文字に変換します |
gmoZipCode | ✔ | 全半角 8桁 | 購入者情報_郵便番号 全角文字は半角文字に変換します。ハイフン省略可です。販売種別:デジコンの加盟店様は任意項目です |
gmoAddress | ✔ | 全半角 55桁 | 購入者情報_住所 半角文字は全角文字に変換します。販売種別:デジコンの加盟店様は任意項目です |
gmoCompanyName | - | 全半角 30桁 | 購入者情報_会社名 半角文字は全角文字に変換します |
gmoDepartmentName | - | 全半角 30桁 | 購入者情報_部署名 半角文字は全角文字に変換します |
gmoTel1 | ✔ | 全半角数字ハイフン 15桁 | 購入者情報_電話番号1 全角文字は半角文字に変換します。ハイフン省略可です |
gmoTel2 | - | 全半角数字ハイフン 15桁 | 購入者情報_電話番号2 全角文字は半角文字に変換します。ハイフン省略可です |
gmoEmail1 | ✔ | 全半角 100桁 | 購入者情報_メールアドレス1 全角文字は半角文字に変換します。「&」の文字は &に置換して登録してください |
gmoEmail2 | - | 全半角 100桁 | 購入者情報_メールアドレス2 全角文字は半角文字に変換します。「&」の文字は &に置換して登録してください |
gmoBilledAmount | ✔ | 半角数字 6桁 | 購入者情報_顧客請求額 税送料込の取引金額です |
gmoExtend1 | - | 半角数字 5桁 | GMO拡張項目1 データはNullをセットします |
gmoSex | - | 半角数字 1桁 | 購入者情報_性別 0:不明 1:男性 2:女性。全角文字は半角文字に変換します |
gmoBirthday | - | 日付10桁固定 (YYYY/MM/DD) | 購入者情報_誕生日 お客様の誕生日です |
gmoMemberId | - | 半角英数記号 200桁 | 購入者情報_会員ID 加盟店で管理している顧客IDです |
gmoBnplTransactionType | ✔ | 半角数字 1桁固定 | 取引種別 1:締め取引 |
gmoPaymentCount | - | 半角数字 3桁 | 支払回数 1からの数字 |
配送先情報
| パラメータ | 必須 | 制限 | 説明 |
|---|---|---|---|
gmoFullNameDelivery | - | 全半角 21桁 | 配送先情報_氏名(漢字) 半角文字は全角文字に変換します。購入者情報と配送先情報が異なる場合に設定してください。購入者情報と配送先情報が同一の場合は、キー情報のみ残し内容をセットする必要はありません。 |
gmoFullKanaNameDelivery | - | 全半角 25桁 | 配送先情報_氏名(カナ) 半角文字は全角文字に変換します。 |
gmoZipCodeDelivery | - | 全半角 8桁 | 配送先情報_郵便番号 全角文字は半角文字に変換します。ハイフン省略可です。購入者情報と配送先情報が異なる場合に設定ください。購入者情報と配送先情報が同一の場合は、キー情報のみ残し内容をセットする必要はありません。 |
gmoAddressDelivery | - | 全半角 55桁 | 配送先情報_住所 半角文字は全角文字に変換します。購入者情報と配送先情報が異なる場合に設定ください。購入者情報と配送先情報が同一の場合は、キー情報のみ残し内容をセットする必要はありません。 |
gmoCompanyNameDelivery | - | 全半角 30桁 | 配送先情報_会社名 半角文字は全角文字に変換します。 |
gmoDepartmentNameDelivery | - | 全半角 30桁 | 配送先情報_部署名 半角文字は全角文字に変換します。 |
gmoTelDelivery | - | 全半角数字ハイフン 15桁 | 配送先情報_電話番号 全角文字は半角文字に変換します。ハイフン省略可です。購入者情報と配送先情報が異なる場合に設定ください。購入者情報と配送先情報が同一の場合は、キー情報のみ残し内容をセットする必要はありません。 |
明細情報
明細情報は最大15件まで登録が可能です。15件を超える場合には15件目に「その他商品」等と変更してください。
| パラメータ | 必須 | 制限 | 説明 |
|---|---|---|---|
gmoDetailNameDetail | ✔ | 全半角 300桁 | 明細情報_明細名 半角文字は全角文字に変換します |
gmoDetailPriceDetail | ✔ | 半角数字 6桁 | 明細情報_単価 税込の商品単価をセットしてください |
gmoDetailQuantityDetail | ✔ | 半角数字 5桁 | 明細情報_数量 -9999から99999の範囲 |
gmoGmoExtend2Detail | - | 半角数字 6桁 | GMO拡張項目2 データはNullをセットします |
gmoGmoExtend3Detail | - | 半角数字 5桁 | GMO拡張項目3 データはNullをセットします |
gmoGmoExtend4Detail | - | 半角数字 5桁 | GMO拡張項目4 データはNullをセットします |
transactionSn | - | 半角数字 4桁 | 明細情報_取引通番 複数明細がある場合に明細を特定する際に任意の値を設定します |
gmoDetailBrand | - | 全半角 300桁 | 明細情報_ブランド 半角文字は全角文字に変換します |
gmoDetailCategory | - | 全半角 300桁 | 明細情報_カテゴリ 半角文字は全角文字に変換します |
その他
| パラメータ | 必須 | 制限 | 説明 |
|---|---|---|---|
gmoChksumReq | ✔ | 半角英数記号 | チェックサムリクエスト 詳細はチェックサム情報についてを参照してください |
clientField1 | - | 全半角 100バイト(EUC-JP) | 加盟店自由項目1 取引に関する任意情報。決済処理には利用されず、お客様にも表示されません。 入力した値は、以下の場所で確認できます。 ・取引状態参照 ・管理画面 ・取引配信ファイル 設定できる最大長はEUC-JPで100 byteです。 利用可能な文字は以下のとおりです。 ・半角英数字 ・半角記号(ただし ^、`、{、|、}、~、&、<、>、"、' を除く) ・全角文字 ※氏名・電話番号・メールアドレスなどの個人情報、およびカード番号は入力しないでください。 |
clientField2 | - | 全半角 100バイト(EUC-JP) | 加盟店自由項目2 |
clientField3 | - | 全半角 100バイト(EUC-JP) | 加盟店自由項目3 |
csrfToken | - | 半角英数ハイフン 36桁 | CSRFトークン Webhookの呼び出し時につける任意のパラメーター。CSRF対策のために利用してください |
webhookUrl | - | 半角英数記号 256桁 | Webhook URL 処理結果を通知する加盟店のURLです。httpsから始まるURLを設定します。テスト環境ではhttp可能です |
connectionType | - | 半角数字 1桁固定 | 接続方式 1:OpenAPIタイプ。指定しない場合もOpenAPIタイプとして処理されます |
端末識別情報について
HTTPヘッダ情報
HTTPヘッダ情報は、以下をセミコロンとコロン(;:)で連結した文字列を登録してください。
ヘッダ取得項目:
- Acceptヘッダの値
- Accept-Charsetヘッダの値
- Accept-Encodingヘッダの値
- Accept-Languageヘッダの値
- Client-IPヘッダの値
- Connectionヘッダの値
- X-Do-Not-TrackまたはDNT(Mozilla系)
- Hostヘッダの値
- Referrerヘッダの値
- User-Agentヘッダの値
- Keep-Aliveヘッダの値
- UA-CPUヘッダの値
- Viaヘッダの値
- X-Forwarded-Forヘッダの値
- 上記以外のヘッダの、ヘッダ名と値をハイフン2つ(--)で結合し、それらを全てコロン2つ(::)で接続した値
- お客様のIPアドレス
- 携帯端末の識別ID
注意事項:
- 該当ヘッダが存在しない場合は空文字を連結します
- 項目(15)のみヘッダ名および、コロン(::)を2つ使用して登録します
- 環境等で取得が難しい場合は該当項目をnullで登録します
ヘッダサンプル:
text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8;:;:gzip,deflate,sdch;:ja,enUS;q=0.8,en;q=0.6;:;:keep-alive;:;:atokara.sample.jp;:http://xxx.xxx.xxx/・・・/load_payment_module.php・・・(Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/30.0.1599.69Safari/537.36;:;:;:;:;:Content-Length--1384::Origin--http://xxx.xxx.xxx/:Content-Type--application/・・・;fraudbuster-key=atokara.sample.jp%2320131016113214LBzGq;:125.203.57.230;:
デバイス情報
デバイス情報取得のため、注文確定ページに以下のHTMLコード(<script> タグ)を実装してください。id='fraudbuster'(<input type="hidden"> を想定)にセットされる文字列をデバイス情報に設定してください。
実装できない場合は未設定で構いません。
<input type="hidden" id="fraudbuster" name="fraudbuster" class="gmoDeviceInfo" />
<script type="text/javascript" src="https://cdn.credit.gmo-ab.com/psdatacollector.js"></script>
チェックサム情報について
チェックサムを利用して送受信データの改ざんを防ぎます。
チェックサムが以下の仕様と異なる値である場合、処理は実行されず、エラーコード ST0001 が返却されます。
チェックサム作成方法
チェックサムは以下の仕様に従い、文字列のハッシュ値をエンコードして作成します。
チェックサムリクエスト
各項目の間に |(パイプ)を指定する必要があります。
base64( sha256 ( キー情報 + | + オーダーID + | + 電話番号1 + | + 郵便番号 + | + 顧客請求額 + | + 性別 + | + 誕生日 + | + "" + | + "" + | + "" + | + 会員ID ))
- キー情報 = 加盟店コード + 接続パスワード
- 接続パスワード = アトカラ契約時にアトカラから発行されるAPI接続用パスワード
チェックサム生成サンプル(Node.js)
const { createHash } = await import('node:crypto');
function makeCheckSum(str) {
const hash = createHash('sha256');
return hash.update(str).digest('base64');
}
// キー情報
const key = 'ab000081-001234567890';
// オーダーID
const orderId = 'test20160509153718';
// 電話番号1
const tel1 = '09012340100';
// 郵便番号
const zipCode = '150-0043';
// 顧客請求金額
const billedAmount = '22001';
// 性別
const sex = '1';
// 誕生日
const birthday = '1980/01/01';
// 会員ID
const memberId = 'aaa@atokara.jp';
const str = [
key, orderId, tel1, zipCode, billedAmount,
sex, birthday, '', '', '', memberId
].join('|');
makeCheckSum(str);
// 7V0RqvMalxUoDaPdL33nFaGo3PoONpM0w/3VSNiJiRM=
チェックサム生成サンプル(Java)
import java.security.MessageDigest;
import java.util.Base64;
import java.util.List;
// キー情報
String key = "ab000081-001234567890";
// オーダーID
String orderId = "test20160509153718";
// 電話番号1
String tel1 = "09012340100";
// 郵便番号
String zipCode = "150-0043";
// 顧客請求金額
String billedAmount = "22001";
// 性別
String sex = "1";
// 誕生日
String birthday = "1980/01/01";
// 会員ID
String memberId = "aaa@atokara.jp";
String str = String.join("|", List.of(
key, orderId, tel1, zipCode, billedAmount, sex,
birthday, "", "", "", memberId
));
String checksum = Base64.getEncoder().encodeToString(
MessageDigest.getInstance("SHA-256").digest(str.getBytes())
);
// 7V0RqvMalxUoDaPdL33nFaGo3PoONpM0w/3VSNiJiRM=
チェックサムレスポンス
チェックサムレスポンスでは、正しいチェックサムの値が返却されていることを確認してください。
chksumRes と chksumRes2 が返却されますが、より安全な chksumRes2 で確認してください。
base64( sha256( キー情報 + アトカラ取引ID + オーダーID + 顧客請求額 + 自動審査結果 ))
レスポンス
アトカラ取引登録のレスポンス項目は以下のとおりです。
処理結果
| パラメータ | 制限 | 説明 |
|---|---|---|
result | - | 処理結果。OK:処理成功 NG:処理失敗 |
errors | - | エラー詳細 |
errors.error | - | エラー情報。複数返却される場合があります |
errors.error.errorCode | 半角英数 20桁 | エラーコード。処理結果がNGの場合のみ存在します |
errors.error.errorMessage | 半角英数 256桁 | エラーメッセージ。処理結果がNGの場合のみ存在します |
取引登録結果
| パラメータ | 制限 | 説明 |
|---|---|---|
transactionResult.orderId | 半角英数記号 27桁 | オーダーID |
transactionResult.atokaraTransactionId | 半角英数 11桁固定 | アトカラ取引ID。処理結果がOKの場合のみ存在し、アトカラにて付加される取引IDです |
transactionResult.authorResult | 全半角 3桁 | 自動審査結果。OK/NG/審査中のいずれかを返却します(処理結果がOKの場合のみ) |
transactionResult.accessId | 半角英数 32桁固定 | 取引ID。処理結果がOKの場合のみ存在する取引固有のID |
transactionResult.accessPass | 半角英数 32桁固定 | 取引パスワード。処理結果がOKの場合のみ存在する取引固有のパスワード |
transactionResult.status | 半角英字 7桁 | 現状態。AUTH/SHIPPED/PAYFAIL/PENDINGのいずれかを返却します(処理結果がOKの場合のみ) |
transactionResult.chksumRes | 半角英数記号 | チェックサムレスポンス(処理結果がOKの場合のみ) |
transactionResult.chksumRes2 | 半角英数記号 | チェックサムレスポンス2(処理結果がOKの場合のみ) |
transactionResult.token | 半角英数 36桁固定 | トークン。内部処理用のため利用する必要がありません |
transactionResult.responseCode | 半角英数 2桁固定 | レスポンスコード。内部処理用のため利用する必要がありません |
transactionResult.smsAuthentication | 半角英数 1桁固定 | SMS認証。有無を返却します(0:なし, 1:あり) |
transactionResult.reEnterFlag | 半角英数 2桁固定 | 再入力可否。お客様情報入力画面で規定回数以上のリトライが実行された場合、NGを返却します |
transactionResult.telAndMmailEnterNum | 半角数字 3桁 | 電話番号&メールアドレス入力回数。お客様情報入力画面で電話番号、メールアドレスが入力された回数を返却します |
transactionResult.paymentCount | 半角数字 3桁 | 支払回数。内部処理用のため利用する必要がありません |
配送先情報
| パラメータ | 制限 | 説明 |
|---|---|---|
deliveries.delivery.details.detail.detailName | 全半角 300桁 | 明細名 |
deliveries.delivery.details.detail.detailPrice | 半角数字 6桁 | 単価 |
deliveries.delivery.details.detail.detailQuantity | 半角数字 5桁 | 数量 |
deliveries.delivery.details.detail.transactionSn | 半角数字 4桁 | 取引通番 |
エラーコード一覧
アトカラ取引登録のエラーコード一覧は以下のとおりです。
認証情報エラー
| コード | エラー種類 | エラー内容 | 説明 |
|---|---|---|---|
SP0001 | 認証情報エラー | 認証IDが未入力です | 認証IDが入力されていない場合に返却します |
SP0002 | 認証情報エラー | 認証IDの文字数が異なります | 認証IDの文字数が11文字と異なる場合に返却します |
SP0003 | 認証情報エラー | 認証IDの値が不正です | 認証IDが半角英数文字列ではない場合に返却します |
SP0004 | 認証情報エラー | 加盟店コードが未入力です | 加盟店コードが入力されていない場合に返却します |
SP0005 | 認証情報エラー | 加盟店コードの文字数が異なります | 加盟店コードの文字数が11文字と異なる場合に返却します |
SP0006 | 認証情報エラー | 加盟店コードの値が不正です | 加盟店コードが半角英数文字列ではない場合に返却します |
SP0010 | 認証情報エラー | 加盟店認証に失敗しました | 加盟店コード及び接続パスワードで認証失敗した場合に返却します |
SP0024 | 認証情報エラー | SMS認証用パスワードが未入力です | SMS認証用パスワードが入力されていない場合に返却します |
SP0025 | 認証情報エラー | SMS認証用パスワードの文字数が異なります | SMS認証用パスワードの文字数が19文字と異なる場合に返却します |
SP0026 | 認証情報エラー | SMS認証用パスワードの値が不正です | SMS認証用パスワードが半角英数文字列ではない場合に返却します |
SP0034 | 認証情報エラー | チェックサムが未入力です | チェックサムが入力されていない場合に返却します |
購入者情報エラー
| コード | エラー種類 | エラー内容 | 説明 |
|---|---|---|---|
CT0001 | 購入者情報エラー | オーダーIDが未入力です | オーダーIDが入力されていない場合に返却します |
CT0002 | 購入者情報エラー | オーダーIDの文字数が異なります | オーダーIDの文字数が1~50文字ではない場合に返却します |
CT0003 | 購入者情報エラー | オーダーIDの値が不正です | オーダーIDが半角英数文字列ではない場合に返却します |
CT0004 | 購入者情報エラー | 注文日が未入力です | 加盟店注文日が入力されていない場合に返却します |
CT0005 | 購入者情報エラー | 注文日の文字数が異なります | 加盟店注文日の文字数が10文字ではない場合に返却します |
CT0006 | 購入者情報エラー | 注文日の値が不正です | 加盟店注文日が日付ではない場合に返却します |
CT0007 | 購入者情報エラー | 購入者の氏名(漢字)が未入力です | 購入者の氏名(漢字)が入力されていない場合に返却します |
CT0008 | 購入者情報エラー | 購入者の氏名(漢字)の文字数が異なります | 購入者の氏名(漢字)の文字数が1~42文字ではない場合に返却します |
CT0009 | 購入者情報エラー | 購入者の氏名(漢字)の値が不正です | 購入者の氏名(漢字)が全角文字列ではない場合に返却します |
CT0010 | 購入者情報エラー | 購入者の氏名(カナ)の文字数が異なります | 購入者の氏名(カナ)に入力があり、文字数が1~50文字でない場合に返却します |
CT0011 | 購入者情報エラー | 購入者の氏名(カナ)の値が不正です | 購入者の氏名(カナ)に入力があり、全角文字列ではない場合に返却します |
CT0012 | 購入者情報エラー | 購入者の郵便番号が未入力です | 購入者の郵便番号が入力されていない場合に返却します |
CT0013 | 購入者情報エラー | 購入者の郵便番号の文字数が異なります | 購入者の郵便番号の文字数が7~8文字ではない場合に返却します |
CT0014 | 購入者情報エラー | 購入者の郵便番号の値が不正です | 購入者の郵便番号が半角数字とハイフンではない場合に返却します |
CT0015 | 購入者情報エラー | 購入者の住所が未入力です | 購入者の住所が入力されていない場合に返却します |
CT0016 | 購入者情報エラー | 購入者の住所の文字数が異なります | 購入者の住所の文字数が1~110文字ではない場合に返却します |
CT0017 | 購入者情報エラー | 購入者の住所の値が不正です | 購入者の住所が全角文字列ではない場合に返却します |
CT0018 | 購入者情報エラー | 購入者の会社名の文字数が異なります | 購入者の会社名に入力があり、文字数が2~60文字ではない場合に返却します |
CT0019 | 購入者情報エラー | 購入者の会社名の値が不正です | 購入者の会社名に入力があり、全角文字列ではない場合に返却します |
CT0020 | 購入者情報エラー | 購入者の部署名の文字数が異なります | 購入者の部署名に入力があり、文字数が2~60文字ではない場合に返却します |
CT0021 | 購入者情報エラー | 購入者の部署名の値が不正です | 購入者の部署名に入力があり、全角文字列ではない場合に返却します |
CT0022 | 購入者情報エラー | 購入者の電話番号1が未入力です | 購入者の電話番号が入力されていない場合に返却します |
CT0023 | 購入者情報エラー | 購入者の電話番号1の文字数が異なります | 購入者の電話番号の文字数が8~17文字ではない場合に返却します |
CT0024 | 購入者情報エラー | 購入者の電話番号1の値が不正です | 購入者の電話番号が半角数字とハイフンではない場合に返却します |
CT0025 | 購入者情報エラー | 購入者の電話番号2の文字数が異なります | 購入者の携帯電話番号に入力があり、文字数が8~17文字ではない場合に返却します |
CT0026 | 購入者情報エラー | 購入者の電話番号2の値が不正です | 購入者の携帯電話番号に入力があり、半角数字とハイフンではない場合に返却します |
CT0027 | 購入者情報エラー | 購入者のメールアドレス1の文字数が異なります | 購入者のメールアドレス1に入力があり、文字数が7~100文字ではない場合に返却します |
CT0028 | 購入者情報エラー | 購入者のメールアドレス1の値が不正です | 購入者のメールアドレス1に入力があり、半角文字列ではない、またはxxx@xxx.xxxの形式ではない場合に返却します |
CT0029 | 購入者情報エラー | 購入者のメールアドレス2の文字数が異なります | 購入者のメールアドレス2に入力があり、文字数が7~100文字ではない場合に返却します |
CT0030 | 購入者情報エラー | 購入者のメールアドレス2の値が不正です | 購入者のメールアドレス2に入力があり、半角文字列ではない、またはxxx@xxx.xxxの形式ではない場合に返却します |
CT0031 | 購入者情報エラー | 顧客請求額が未入力です | 顧客請求額が入力されていない場合に返却します |
CT0032 | 購入者情報エラー | 顧客請求額の文字数が異なります | 顧客請求額の文字数が1~6文字ではない場合に返却します |
CT0033 | 購入者情報エラー | 顧客請求額の値が不正です | 顧客請求額が半角数字ではない場合に返却します |
CT0047 | 購入者情報エラー | 購入者の郵便番号と住所が一致しません | 購入者の郵便番号と住所に入力があり、郵便番号と住所が一致しない場合に返却します |
CT0057 | 購入者情報エラー | 購入者の丁番地または建造物名/号室等を入力してください | 購入者情報の住所に丁番地・建造物名/号室等が入力されていない場合に返却します |
CT0058 | 購入者情報エラー | 購入者の電話番号が携帯電話番号ではありません | 購入者情報の電話番号が携帯電話番号でない場合に返却します |
CT0059 | 購入者情報エラー | 性別の文字数が異なります | 性別の文字数が1文字ではない場合に返却します |
CT0060 | 購入者情報エラー | 性別の値が不正です | 性別が半角数字ではない場合、または加盟店で利用できない性別の数字の場合に返却します |
CT0061 | 購入者情報エラー | 誕生日の文字数が異なります | 誕生日の文字数が10文字ではない場合に返却します |
CT0062 | 購入者情報エラー | 誕生日の値が不正です | 誕生日が日付ではない場合に返却します |
CT0077 | 購入者情報エラー | 会員IDの文字数が異なります | 会員IDの文字数が1~200文字ではない場合に返却します |
CT0078 | 購入者情報エラー | 会員IDの値が不正です | 会員IDが半角数字記号ではない場合に返却します |
CT0088 | 購入者情報エラー | BNPL会員IDの文字数が異なります | 会員IDの文字数が12文字ではない場合に返却します |
CT0089 | 購入者情報エラー | BNPL会員IDの値が不正です | 会員IDが半角英数表記ではない場合に返却します |
CT0097 | 購入者情報エラー | 支払回数の文字数が異なります | 支払い回数の文字数が1~3文字ではない場合に返却します |
CT0098 | 購入者情報エラー | 支払回数の値が不正です | 支払回数が半角数字でない場合に返却します |
CT0099 | 購入者情報エラー | 購入者のメールアドレス1が未入力です | 購入者のメールアドレス1が入力されていない場合に返却します |
CT0101 | 購入者情報エラー | 顧客請求金額が分割可能金額未満です | 顧客請求金額が分割可能金額未満の場合に返却します |
CT0104 | 購入者情報エラー | SMS認証結果の文字数が異なります | SMS認証結果の文字数が2文字ではない場合に返却します |
CT0105 | 購入者情報エラー | SMS認証結果の値が不正です | SMS認証結果が半角英数記号ではない場合に返却します |
CT0107 | 購入者情報エラー | 該当する会員は利用停止中です | 利用者ステータスが'6'(利用停止)の場合に返却します |
CT0109 | 購入者情報エラー | 保留審査結果の文字数が異なります | 保留審査結果の文字数が2文字ではない場合に返却します |
CT0110 | 購入者情報エラー | 保留審査結果の値が不正です | 保留審査結果が半角英数記号ではない場合に返却します |
配送先情報エラー
| コード | エラー種類 | エラー内容 | 説明 |
|---|---|---|---|
DL0001 | 配送先情報エラー | 配送先1の氏名(漢字)が未入力です | 配送先1の氏名(漢字)が入力されていない場合に返却します |
DL0002 | 配送先情報エラー | 配送先1の氏名(漢字)の文字数が異なります | 配送先1の氏名(漢字)の文字数が1~42文字ではない場合に返却します |
DL0003 | 配送先情報エラー | 配送先1の氏名(漢字)の値が不正です | 配送先1の氏名(漢字)が全角文字列ではない場合に返却します |
DL0005 | 配送先情報エラー | 配送先1の氏名(カナ)の文字数が異なります | 配送先1の氏名(カナ)の文字数が1~50文字ではない場合に返却します |
DL0006 | 配送先情報エラー | 配送先1の氏名(カナ)の値が不正です | 配送先1の氏名(カナ)が全角文字列ではない場合に返却します |
DL0007 | 配送先情報エラー | 配送先1の郵便番号が未入力です | 配送先1の郵便番号が入力されていない場合に返却します |
DL0008 | 配送先情報エラー | 配送先1の郵便番号の文字数が異なります | 配送先1の郵便番号の文字数が7~8文字ではない場合に返却します |
DL0009 | 配送先情報エラー | 配送先1の郵便番号の値が不正です | 配送先1の郵便番号が半角数字とハイフンではない場合に返却します |
DL0010 | 配送先情報エラー | 配送先1の住所が未入力です | 配送先1の住所が入力されていない場合に返却します |
DL0011 | 配送先情報エラー | 配送先1の住所の文字数が異なります | 配送先1の住所の文字数が1~110文字ではない場合に返却します |
DL0012 | 配送先情報エラー | 配送先1の住所の値が不正です | 配送先1の住所が全角文字列ではない場合に返却します |
DL0013 | 配送先情報エラー | 配送先1の会社名の文字数が異なります | 配送先1の会社名に入力があり、文字数が2~60文字ではない場合に返却します |
DL0014 | 配送先情報エラー | 配送先1の会社名の値が不正です | 配送先1の会社名に入力があり、全角文字列ではない場合に返却します |
DL0015 | 配送先情報エラー | 配送先1の部署名の文字数が異なります | 配送先1の部署名に入力があり、文字数が2~60文字ではない場合に返却します |
DL0016 | 配送先情報エラー | 配送先1の部署名の値が不正です | 配送先1の部署名に入力があり、全角文字列ではない場合に返却します |
DL0017 | 配送先情報エラー | 配送先1の電話番号の文字数が異なります | 配送先1の電話番号に入力があり、文字数が8~17文字ではない場合に返却します |
DL0018 | 配送先情報エラー | 配送先1の電話番号の値が不正です | 配送先1の電話番号に入力があり、半角数字とハイフンではない場合に返却します |
DL0019 | 配送先情報エラー | 配送先1の郵便番号と住所が一致しません | 配送先1の郵便番号と住所に入力があり、郵便番号と住所が一致しない場合に返却します |
DL0020 | 配送先情報エラー | 配送先情報は0箇所のみ登録可能です | 配送先情報が0件より多くの登録があった場合に返却します |
DL0021 | 配送先情報エラー | 配送先1の丁番地または建造物名/号室等を入力してください | 配送先1の住所に丁番地・建造物名/号室等が入力されていない場合に返却します |
DL0024 | 配送先情報エラー | 配送先1の電話番号が未入力です | 配送先1の電話番号が入力されていない場合に返却します |
商品明細情報エラー
| コード | エラー種類 | エラー内容 | 説明 |
|---|---|---|---|
DT0001 | 商品明細情報エラー | 配送先1明細1の明細名が未入力です | 配送先1明細1の明細名が入力されていない場合に返却します |
DT0002 | 商品明細情報エラー | 配送先1明細1の明細名の文字数が異なります | 配送先1明細1の明細名の文字数が1~300文字ではない場合に返却します |
DT0003 | 商品明細情報エラー | 配送先1明細1の明細名の値が不正です | 配送先1明細1の明細名が全角文字列ではない場合に返却します |
DT0004 | 商品明細情報エラー | 配送先1明細1の単価が未入力です | 配送先1明細1の単価が入力されていない場合に返却します |
DT0005 | 商品明細情報エラー | 配送先1明細1の単価の文字数が異なります | 配送先1明細1の単価の文字数が1~6文字ではない場合に返却します |
DT0006 | 商品明細情報エラー | 配送先1明細1の単価の値が不正です | 配送先1明細1の単価が半角数字ではない場合に返却します |
DT0007 | 商品明細情報エラー | 配送先1明細1の数量が未入力です | 配送先1明細1の数量が入力されていない場合に返却します |
DT0008 | 商品明細情報エラー | 配送先1明細1の数量の文字数が異なります | 配送先1明細1の数量の文字数が1~5文字ではない場合に返却します |
DT0009 | 商品明細情報エラー | 配送先1明細1の数量の値が不正です | 配送先1明細1の数量が半角数字ではない場合に返却します |
DT0010 | 商品明細情報エラー | 商品情報は0個まで登録可能です | 0より多く登録されている場合に返却します |
DT0014 | 商品明細情報エラー | 配送先1明細1のブランドの文字数が異なります | 配送先1明細1のブランドの文字数が1~300文字ではない場合に返却します |
DT0015 | 商品明細情報エラー | 配送先1明細1のブランドの値が不正です | 配送先1明細1のブランドが全角文字列ではない場合に返却します |
DT0016 | 商品明細情報エラー | 配送先1明細1のカテゴリの文字数が異なります | 配送先1明細1のカテゴリの文字数が1~300文字ではない場合に返却します |
DT0017 | 商品明細情報エラー | 配送先1明細1のカテゴリの値が不正です | 配送先1明細1のカテゴリが全角文字列ではない場合に返却します |
システムエラー
| コード | エラー種類 | エラー内容 | 説明 |
|---|---|---|---|
ST0001 | システムエラー | 処理に失敗しました。詳細についてはシステム担当者にご連絡ください | 処理が失敗した場合に返却します |
ST0002 | システムエラー | タイムアウトしました。詳細についてはシステム担当者にご連絡ください | タイムアウトした場合に返却します |
MP0001 | システムエラー | 窓口にお問い合わせしてください | アトカラシステムと当サービス間でエラーが発生した場合に返却します。詳細について担当者にご連絡ください |