テスト環境で決済を実行する

決済処理は以下の流れで実施されます。

加盟店様には値段などの各種パラメータを渡してfincode APIにアクセスしていただきます。

クレジットカード決済を行う

クレジットカードの決済処理を実際に行ってみましょう。
決済登録APIと決済実行APIを使って行います。
まずは決済登録APIで決済登録を行います。以下にサンプルコードを載せていますので、利用して登録してみてください。

決済登録API

cURL
Python
Go
Node.js

Terminal

1 2 3 4
curl https://api.test.fincode.jp/v1/payments \ -H "Content-Type: application/json" \ -H "Authorization: Bearer m_test_OGY1YWE" \ -d '{"pay_type": "Card", "job_code": "CAPTURE", "amount": "500"}'

決済実行APIにアクセスするためには加盟店側の情報に加えて、決済登録APIから返ってきた値を渡す必要があります。

"id": "o_MX2aLSOxR6OI0abmJWs_gg"
"access_id": "a_25Q1AoBJQzC9ydXPigtJ6g"

また、セキュリティ上、購入者のカード情報を扱うにはカード情報をトークンにするか、決済実行JSを利用していただく必要があります。
今回は決済実行JSを利用して決済を行います。決済実行JSでは購入者のブラウザから直接fincodeの決済実行APIを実行するため、カード番号が加盟店様サーバーを経由せず安全です。
決済実行JSは購入者のブラウザから直接fincodeの決済実行APIを実行するためのスクリプトです。カード番号が加盟店様サーバーを経由しないため安全です。
決済実行JSによって決済実行処理を行うことで決済処理は完了です。

例）ECサイト(ブラウザ)の入力フォーム

決済実行JS

JavaScript

client.js

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
function postForm( calltype ){ // 加盟店様ごとのAPIキー(パブリックキー)読込 const api_key=<パブリックキー>; // Fincodeインスタンスを生成 let fincode = Fincode(api_key); // 決済実行に必要なデータを宣言 const transaction = { // オーダーID id: document.getElementById("order_id").value, // 決済種別 pay_type: document.getElementById("pay_type").value, // 取引ID access_id: document.getElementById("access_id").value, // 支払い方法 method: document.getElementById("method").value, // カード番号 card_no : document.getElementById("card_no").value, // 有効期限 yymm形式 expire : document.getElementById("expire").value, // カード名義人 holder_name: document.getElementById("holder_name").value, // セキュリティコード security_code: document.getElementById("security_code").value, }; // 決済実行 fincode.payments(transaction, function (status, response) { if (status === 200) { // リクエスト正常時の処理 console.log(response); } else { // リクエストエラー時の処理 console.log(response); } }, function () { // 通信エラー処理 console.log("ERROR"); }); }

レスポンス

Text

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40
{ "acs":"0", "shop_id":"s_21102695529", "id":"1638492999528gkp", "pay_type":"Card", "status":"CAPTURED", "access_id":"a_vr12yeSxQE-X-QE47_8ZTw", "process_date":"2021/12/03 10:04:36.695", "job_code":"CAPTURE", "item_code":"0000990", "amount":500, "tax":0, "total_amount":500, "customer_group_id":null, "customer_id":null, "card_no":"************1111", "card_id":null, "expire":"2512", "holder_name":"aaaa", "card_no_hash":"9bbef19476623ca56c17da75fd57734dbf82530686043a6e491c6d71befe8f6e", "method":"1", "pay_times":null, "forward":"15250", "issuer":"9999999", "transaction_id":"2112031004602250501600908094", "approve":"0123456", "auth_max_date":null, "client_field_1":null, "client_field_2":null, "client_field_3":null, "tds_type":"0", "tds2_type":null, "tds2_ret_url":null, "tds2_status":null, "merchant_name":null, "send_url":null, "error_code":null, "created":"2021/12/03 09:56:41.782", "updated":"2021/12/03 10:04:36.695"}

決済の取引情報はダッシュボード、または決済情報取得APIから確認することができます。
ダッシュボードのサイドメニューの［決済］を選択します。
決済情報が一覧で表示されているのが確認できます。
決済情報の状態について詳しくはこちらをご覧ください。

決済の現状態説明表

現状態（取引の状態）	説明
利用可能な金額	1円～9,999,999円 (利用金額と税送料の合計)

次のステップ

テスト環境で通知設定を行う（Webhook）