決済実行
- 都度決済
決済が発生するごとに、その都度決済を行うことから、都度決済と称しています。
- 継続決済
一度目の決済完了時に決済情報を保存し、定期的(年、月、週、日、曜日)に自動で決済することを継続決済と称しています。
次回以降はバッチにて処理が行われます(12:00頃)。 決済情報はサイトごとに一意である顧客ID(CustomerId)によって管理されます。 一つの顧客IDに対して初回の決済金額と次回以降の決済金額を設定できますが、設定できるパターンは一つのみです。
URL
/service/credit
送信パラメータ
| パラメータ名 | タイプ | 桁数 | 必須 | 内容 |
|---|---|---|---|---|
| SiteId | 半角数字 | 8 | 〇 | 弊社が発行したID。 |
| SitePass | 半角英数字 | 8 | 〇 | 弊社が発行したパスワード。 |
| Amount | 半角数字 | 8 | 〇 | 決済金額(継続決済の場合は初回決済金額)を送信してください。 |
| Amount2 | 半角数字 | 8 | 次回決済金額(継続決済の2回目以降の決済金額)を送信してください。継続決済で未指定時は決済金額が使用されます。 | |
| max_cont | 半角数字 | 2 | 継続決済の回数制限を行う場合は、決済回数を送信してください。 指定した回数で継続決済を終了させることができます。送信する数値は、初回決済の回数を含みます。 例: 1. Amount=500、max_cont=5 で決済した場合 500 円の初回決済1回、500 円の継続決済4回 2. Amount=100、Amount2=500、max_cont=10 で決済した場合 100 円の初回決済1 回、500 円の継続決済9 回 |
|
| itemId | 半角英数字、全角 | 100 | 商品を特定する任意のIDを送信してください。 ":"区切り及び","区切りで送信する事により商品の明細を決済画面に表示する事が可能です。 例： ITEM01:商品01,ITEM02:商品02 商品A,単価1000円,数量2,計2000 |
|
| CustomerId | 半角英数字 | 50 | 決済を実行するお客様を特定する一意のIDを送信してください。 サイトごとに一意である必要があります。 (クイックチャージ使用時は CustomerId 必須です) |
|
| CustomerPass | 半角英数字 | 50 | 決済を実行するお客様パスワードを送信してください。 (クイックチャージ使用時は CustomerPass か email のどちらかが必須です) |
|
| country | 半角英字 | 2 | 決済を実行するお客様の国コードを送信してください。(ISO3166-2規格の2文字国コードです) 例： JP,US |
|
| zip | 半角英数字 | 30 | 決済を実行するお客様の郵便番号を送信してください。 | |
| capital | 半角英数字、全角 | 50 | 決済を実行するお客様の都道府県を送信してください。 例： 東京都 | |
| adr1 | 半角英数字、全角 | 100 | 決済を実行するお客様の住所を送信してください。 | |
| adr2 | 半角英数字、全角 | 100 | 決済を実行するお客様の住所(建物名等)を送信してください。 | |
| name | 半角英数字、全角 | 100 | 決済を実行するお客様の氏名を送信してください。 | |
| namekana | 全角カナ | 100 | 決済を実行するお客様の氏名(カナ)を送信してください。 | |
| tel | 半角英数字 | 30 | 決済を実行するお客様の電話番号を送信してください。 | |
| 半角英数字 | 255 | 決済を実行するお客様のメールアドレスを送信してください。入力されたアドレスへ決済成功時に決済の明細が送信されます。 | ||
| gender | 半角英数字 | 20 | 決済を実行するお客様の性別を送信してください。 例： MALE,FEMALE |
|
| birthday_year | 半角数字 | 4 | 決済を実行するお客様の生年月日(年)を送信してください。 | |
| birthday_month | 半角数字 | 2 | 決済を実行するお客様の生年月日(月)を送信してください。 | |
| birthday_day | 半角数字 | 2 | 決済を実行するお客様の生年月日(日)を送信してください。 | |
| custom1 | 任意 | 100 | 加盟店様固有のカスタム項目を送信してください。カスタム項目の表示名称は予め弊社管理画面で設定しておく必要があります。 | |
| custom2 | 任意 | 100 | 加盟店様固有のカスタム項目を送信してください。カスタム項目の表示名称は予め弊社管理画面で設定しておく必要があります。 | |
| custom3 | 任意 | 100 | 加盟店様固有のカスタム項目を送信してください。カスタム項目の表示名称は予め弊社管理画面で設定しておく必要があります。 | |
| note | 半角英数字、全角 | 100 | 決済を実行するお客様の備考を送信してください。 | |
| SiteTransactionId | 半角英数字 | 50 | 個々の決済を区別する御社側の識別IDを送信してください。 | |
| language | 半角英数字 | 2 | 画面の表示言語を送信してください。 日本語=ja, 英語=en, 韓国語=ko, 中国語=zh 通常はブラウザの言語を自動で判別します。 ブラウザの設定言語が、弊社システム対応外言語の場合は、決済画面を英語で表示します。 |
サンプル
フォームの値について
「決済サーバ」の値については、 決済サーバ ページをご確認ください。
「サイトID・サイトPASS」については、弊社からお送りしている登録完了メールや加盟店管理画面に記載がございます。
ご不明な場合は弊社加盟店窓口までお問い合わせください。
継続決済契約なし
- 都度決済(金額が固定の場合)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="hidden" name="Amount" value="210">
<input type="submit">
</form>
- 都度決済(金額を加盟店様のWEBページから入力する場合)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="text" name="Amount" value="" required>
<input type="submit">
</form>
継続決済契約あり
注意点
継続決済契約があるサイトで都度決済を行いたい場合はmax_contを1に設定してください。
指定がない場合、継続決済として処理され複数回の決済が発生します。
- 都度決済(金額が固定の場合)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="hidden" name="Amount" value="210">
<input type="hidden" name="max_cont" value="1">
<input type="submit">
</form>
- 都度決済(金額を加盟店様のWEBページから入力する場合)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="text" name="Amount" value="" required>
<input type="hidden" name="max_cont" value="1">
<input type="submit">
</form>
- 継続決済(100円の継続課金)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="hidden" name="Amount" value="100">
<input type="submit">
</form>
- 継続決済(初回100円、2回目以降200円の継続課金)
<form action="https://決済サーバ/service/credit" method="post" accept-charset="UTF-8">
<input type="hidden" name="SiteId" value="ここにサイトIDを記入">
<input type="hidden" name="SitePass" value="ここにサイトPASSを記入">
<input type="hidden" name="Amount" value="100">
<input type="hidden" name="Amount2" value="200">
<input type="submit">
</form>
ご注意ください
<form action="~" method="post" accept-charset="UTF-8" target="_blank">のようにtarget="_blank"は指定しないでください。
一部スマートフォンやブラウザによってはパラメータが正しく受けとれず決済画面が表示されません。