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

アトカラ 概要

概要​

アトカラはGMOペイメントサービスと三井住友カードがブランド管理をする、分割払いも可能な後払い決済サービスです。
6回払いまでは分割手数料無料、最大36回払いまで対応しています。

お客様は携帯電話番号とメールアドレスのみで簡単に利用できます。
お客様の申込・利用・請求確認までの手続きが全てWEBで完結するため、
加盟店様は紙運用や個別案内の対応を抑えられ、業務負担の軽減につながります。

overview
  • 決済金額の上限： 500,000円
    • 与信枠は加盟店様共通で設定されており、他加盟店様分も含めた累計金額が上限を超過した場合、与信審査NGとなります
  • 決済金額の下限： 1円
  • 利用可能地域 / 通貨：日本 / JPY
  • 返金 / 金額変更： 可 / 可

アトカラを始めるには​

  1. 契約の確認・申込
    ご利用にはアトカラの契約が必要です。未契約の場合は営業担当へご連絡ください。
    金額変更（増額）の利用は別途オプション契約が必要です。

  2. テスト環境での動作確認
    テスト環境に関する情報はこちらを確認してください。

  3. 本番稼働開始
    動作確認完了後、本番運用を開始します。
    ※テスト環境⇒本番環境への切り替えチェックリストはこちら

接続方式のサポート​

接続方式サポート状況関連リンク
OpenAPIタイプ✔ 対応API仕様
プロトコルタイプ✖ 非対応─
リンクタイプ Plus✔ 対応API仕様／決済識別子

取引状態​

アトカラで取り得る取引状態は以下の通りです。

取引状態コード説明
未決済UNPROCESSED新規に取引を登録し与信審査前の状態
保留PENDING与信審査にて、アトカラから審査中が返却された状態
仮売上AUTH与信審査にて、アトカラから審査OKが返却された状態
出荷済SHIPPED商品の発送が完了した状態。以下いずれかの場合に該当。
・即時売上運用：与信審査にて、アトカラから審査OKが返却された状態
・仮売上／実売上運用：出荷報告（/deferredpay/shipping）APIが正常に完了した状態
即時売上CAPTURE即時売上運用により売上が確定された状態
実売上SALES仮売上／実売上運用により売上が確定された状態
キャンセルCANCEL仮売上・保留・出荷済の取引がキャンセルされた状態
返品RETURN実売上・即時売上の取引がキャンセルされた状態
強制キャンセルFORCECANCEL以下のキャンセルが実行された状態
・未出荷キャンセル
決済失敗PAYFAIL与信審査で審査NGが返却された状態
関連リンク

アトカラの特徴​

API実装の特性​

アトカラは他の決済手段とは異なる実装方式を採用しています。

フェーズ使用技術説明
取引の作成JavaScript SDKGMOペイメントサービス社が提供する専用SDK（アトカラ取引登録）を
購入画面に組み込み
取引の照会・変更OpenAPIタイプAPI取引照会、出荷報告、キャンセルなどを実施

この2層構造により、フロントエンドとバックエンドで異なる実装アプローチが必要です。
アトカラ取引登録の詳細はアトカラ取引登録 開発ガイドを参照してください。

リンクタイプ Plusでの利用

リンクタイプ Plusでアトカラを利用する場合は、リンクタイプ Plusの決済画面上に
既にJavaScript SDKが組み込まれているため、加盟店様におけるSDK実装は不要です。

与信審査の仕組み​

アトカラの決済処理では、必ず与信審査が実施されます。
与信審査の有効期限は1か月間です。

項目内容
自動の与信審査アトカラ取引登録では自動の与信審査が行われます。
購入画面にて新規会員登録を行った場合のみ、自動審査で保留となり、目視審査が行われます。
自動の与信審査の結果は、最短10秒で返却されます。
目視審査平日の10時/13時/15時/17時に審査が行われ、1時間以内に結果が返却されます。
与信審査について

与信審査は、取引の債権をお引き受けできるか判断する審査です。
登録情報の真偽および商品の到着をお約束するものではありません。

運用方式の選択​

契約時に、商材の特性に応じて以下の運用方式を選択します。

主に物販向け：商品発送のタイミングを制御できる運用方式

特徴内容
適用ケース物理的な商品の販売
売上確定出荷報告（/deferredpay/shipping）API呼び出し後、翌日に自動売上処理
与信有効期限1か月（超過すると未出荷キャンセル）
備考

同一ショップで両方の運用方式を併用することはできません。併用する場合は2つのショップ契約が必要です
ただし、テスト環境のみ、ショップ管理画面から運用方式の切り替えが可能です。

ユーザの種類​

アトカラには「会員」と「非会員」の2種類があり、利用可能なサービス内容が異なります。

項目会員非会員
与信上限金額5万円～50万円（会員審査により変動）5万円（固定）
支払回数1回～36回払い
※6回払いまで分割手数料無料		1回払いのみ
支払方法コンビニ・銀行振込・口座振替コンビニ・銀行振込

与信枠の管理​

与信枠は加盟店様共通で管理されており、他加盟店様分も含めた累計で判定されます。
累計の対象となるのは、審査結果がOKの取引および保留の取引です。

決済・審査の流れ​

アトカラの決済処理は、選択する運用方式により以下の2つのパターンがあります。

主な流れ：

  1. JavaScript SDKで取引を登録し、自動の与信審査を実施
  2. 審査OKで仮売上状態（AUTH）になります
  3. 商品発送後に出荷報告（/deferredpay/shipping）APIを呼び出し、出荷済状態（SHIPPED）に遷移
  4. 翌日に自動売上処理が実行され、実売上状態（SALES）となります
重要

与信審査OK前に商品を発送しないでください。 審査OK前の発送はサービス対象外となります。

審査時間
  • 自動の与信審査：最短10秒で結果が返却されます
  • 目視審査：新規会員登録の場合のみ実施されます。
    平日の10時/13時/15時/17時に審査が行われ、1時間以内に結果が返却されます

重要な制約事項​

アトカラを実装・運用する上で最も重要な制約です。実装開始前に必ず確認してください。

与信審査OK前の商品発送禁止​

与信審査がOKになるまで、絶対に商品を発送しないでください。

  • 取引登録後、与信審査の「OK」が返却されるまで待機する必要があります
  • 与信審査OK前に発送された取引は、サービス対象外となり、アトカラで立替払い対象になりません

購入完了の判定方法​

JavaScript SDKの応答のみで取引成否を判断すると改ざんのリスクがあります。

セキュリティ要件

必ず取引照会（/order/inquiry）APIの結果をもって購入完了の判定を行ってください。

海外からの利用制限​

海外のIPアドレスからのアクセスの場合、JavaScript SDKを利用できません。
また海外発送についてもサポート対象外です。

伝票番号の一意性​

同一伝票番号を複数の取引に登録できません。
複数の取引をまとめて発送する場合は、取引も1つにまとめてください。

使用するAPI​

アトカラの決済処理で使用するAPIは以下の通りです。

共通​

仮売上/実売上運用、即時売上運用の両方で使用します。

仮売上/実売上運用でのみ使用​

基本仕様​

与信の有効期限​

与信審査の有効期限は1か月間です。
出荷報告をせずに1か月を超過した場合、未出荷キャンセルの対象となり、自動的にキャンセルされます。

文字コードと運送会社​

項目内容
利用可能文字アトカラ取引登録ではJIS X 0208に準拠した以下の文字のみ利用可能です。
・ASCII文字
・非漢字（01区～08区）
・JIS第1水準（16区～47区）
・JIS第2水準（48区～84区）
運送会社コード出荷報告（/deferredpay/shipping）API、
出荷変更（/deferredpay/shippingUpdate）APIで指定可能な運送会社コードです。
未設定の場合は自動着荷00が適用されます。

・00：自動着荷
・11：佐川急便
・12：ヤマト運輸
・14：西濃運輸
・15：郵便書留・特定記録郵便
・16：ゆうパック
・18：福山通運
・27：エコ配
・28：レターパック

自動売上処理のタイミング​

出荷済（SHIPPED）になった翌日に自動的に立替払い対象として売上処理をします。
取引状態は仮売上/実売上運用の場合SALES、即時売上運用の場合CAPTUREになります。

返金​

仮売上キャンセル可能期間
仮売上後30日以内

返品可能期間
実売上、即時売上後180日以内

金額変更​

  • 増額・減額ともに可能です。
  • 金額変更の回数に制限はありません。
  • 取引状態により金額変更可能期間が異なります。
取引状態金額変更可能期間
仮売上仮売上後30日以内
実売上実売上後180日以内
即時売上即時売上後180日以内

お客様へのメール送信​

以下のタイミングでアトカラよりお客様にメールが送信されます。

  • 新規会員登録の審査結果連携時
  • 請求確定時（翌月3日）

テスト環境では上記のメールは送信されません。

実装時の注意事項​

アトカラ取引登録と取引変更での文字制限の違い​

アトカラ取引登録と取引変更（/deferredpay/orderUpdate）APIのリクエストパラメータでは、
使用可能な文字種や桁数の制限が異なります。

このため、アトカラ取引登録で正常に受け付けられた文字列であっても、
取引変更時にエラーとなることがあります。エラーが発生しうる項目は、以下の通りです。

項目アトカラ取引登録取引変更
購入者情報_会社名gmoCompanyName(全半角30桁)billingAddress.line3(UTF-8で75Byte)
購入者情報_会員IDgmoMemberId(半角英数記号200桁)payer.accountId(半角英数記号60桁)
購入者情報_誕生日gmoBirthday(YYYY/MM/DD形式)payer.dateOfBirth(YYYYMMDD形式)
購入者情報_氏名（カナ）gmoFullKanaName(全半角25桁)payer.nameKana(UTF-8で60Byte)
購入者情報_電話番号gmoTel1,gmoTel2(全半角数字ハイフン15桁)payer.phones.number(半角数字ハイフン13桁)
配送先情報_会社名gmoCompanyNameDelivery(全半角30桁)shippingAddress.line3(UTF-8で75Byte)
配送先情報_電話番号gmoTelDelivery(全半角数字ハイフン15桁)atokaraInformation.shippingPhone(半角数字ハイフン13桁)
明細情報_明細名gmoDetailNameDetail(全半角300桁)items.name(UTF-8で192Byte)
明細情報_数量gmoDetailQuantityDetail(半角数字5桁)items.quantity(半角数字4桁)
明細情報_カテゴリgmoDetailCategory(全半角300桁)items.category(半角数字4桁)

上記の差異により取引変更時にエラーが発生する場合は、取引変更（/deferredpay/orderUpdate）APIの制限に合わせて値を修正してください。修正が難しい場合は管理画面から変更を行ってください。詳細な制限は各APIのページを参照ください。

キャンセル時の注意事項​

お客様から注文のキャンセルや返品が発生した場合、請求停止のため、速やかに取引のキャンセルを実施してください。

  • お客様と加盟店様の間でトラブルが発生し、お客様が支払を拒否している場合には、キャンセル登録を依頼することがあります
  • キャンセルが遅れるとお客様とトラブルになる場合があるため、お早めの対応をお願いします

テスト環境の利用方法​

テスト環境のご利用について

アトカラのテスト環境は加盟店様共用のため、負荷試験での利用はお控えください。

テスト環境の制約事項：

  • アトカラ取引登録で使用する加盟店コードや接続パスワードは、ショップパターンごとに決まっています
    • ショップパターンは管理画面から変更できます
    • ショップパターンごとの情報は以下の表を参照してください
  • 購入画面での新規会員登録はできません
  • SMS認証のメールは送信されません。SMS認証画面では「0000」を入力してください
  • アトカラのテスト環境は平日8:30~23:00で利用可能です

ショップパターン①​

販売種別：物販 ／ 非会員提供：可 ／ 売上区分：仮売上・実売上

項目値
加盟店コードmb000036-01
認証ID1000000002
SMS認証パスワードB23790DDAFD3A40C32221B971888AD685649C4E5E8132E4007D6DD09870D80C4
接続パスワードg7Tq9M2p

ショップパターン②​

販売種別：物販 ／ 非会員提供：不可 ／ 売上区分：仮売上・実売上

項目値
加盟店コードmb000045-01
認証ID1000000002
SMS認証パスワードE7FF2E885128E4DE64041C3CE32D04B2508CECD6A1BE17D58AA7FF1174684A35
接続パスワードB3vN8zK1

ショップパターン③​

販売種別：デジコン ／ 非会員提供：不可 ／ 売上区分：即時売上

項目値
加盟店コードmb000054-01
認証ID1000000002
SMS認証パスワード4CBBFF02C7D9CE03AFCC9C29FF54F65D9A9D4627700D0D8E4ED31ECC36150B6C
接続パスワードm6Lr2PqX

テスト環境URL​

テスト環境で利用するURLは以下の通りです。

用途URL
アトカラ取引登録用のJavaScripthttps://cdn.stg.atokara.jp/sms/js/gmoSmsCertification.js
デバイス情報取得用のJavaScripthttps://cdn.stg.credit.gmo-ab.com/psdatacollector.js

必ずロゴマーク利用ガイドラインおよびアトカラ_ロゴマニュアルをご確認の上ご利用ください。

アトカラロゴ1 アトカラロゴ2
に最終更新
🤖 LLMですか？llms.txt・llms-apis.txtに各ページの概要とリンクをまとめています。回答生成に活用してください。