10月25日(水)・26日(木)にKOMOJU売上アップセミナーを開催します!

APIを使った決済方法の紹介:PaymentとSession

Share

はじめに

こんにちは!今回は、KOMOJUのAPIを使って基本的な決済を行ってみます。

1. APIとは

API(Application Programming Interface)とは、ソフトウェア同士が通信するためのインターフェースです。APIを利用することで、異なるシステム間でデータのやり取りや機能の呼び出しを行うことができます。KOMOJUのAPIを使用すると、さまざまな決済手段を簡単に統合し、自動化された処理を行うことが可能になります。

2. APIキーの取得

APIキーは、KOMOJUの設定画面で取得できます。非公開鍵の欄に表示されているキーを使用して、APIリクエストを認証します。

3. サンプルコード

ここでは、KOMOJUのAPIを使って決済を行う2種類の方法について、具体的なサンプルコードを紹介します。

① Payment: Create を使う方法

直接「支払い」を作成して決済を行います。最低限、「いくら(amount)」「どの通貨で(currency)」「どの決済手段で(payment_details)」決済し、「どのページに戻るか(return_url)」の情報が必要です。

Payment: Create

				
					curl --request POST \
     --url https://komoju.com/api/v1/payments \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxx' \
     --header 'content-type: application/json' \
     --data '
{
  "currency": "JPY",
  "payment_details": {
    "type": "paypay"
  },
  "amount": 1000,
  "return_url": "https://www.google.com"
}
'
				
			

この方法でクレジットカード決済を行う場合は、サイト自体がPCI-DSSに準拠している必要があります。これに対応し続けるのはなかなか面倒ですので、KOMOJUにはクレジットカードの情報取扱の部分をKOMOJUが代行する形で決済する方法があります。それが、Sessionを使う方法です。

② Sessionを使う方法

まず「Session」を作成し、それを使用して支払いを行います。Sessionとは、KOMOJUのAPIで支払いの前段階として使用されるオブジェクトで、金額や通貨、利用可能な支払い方法のリスト、取引情報などが含まれます。

Session: Createでは、Payment: Createで使用した「どの決済手段で」の情報以外を渡します。 

Session: Create

				
					curl --request POST \ 
    --url https://komoju.com/api/v1/sessions \ 
    --header 'accept: application/json' \
    --header 'authorization: Basic xxxx' \
    --header 'content-type: application/json' \
    --data ' 
{ 
  "payment_data": { 
    "currency": "JPY", 
  },
  "return_url": "https://www.google.com", 
  "amount": 1000, 
  "currency": "JPY" 
} 
'
				
			

その後Session: Payで、「どの決済手段で」決済するかの情報を渡します。

Session: Pay

				
					curl --request POST \
     --url https://komoju.com/api/v1/sessions/xxxx/pay \
     --header 'accept: application/json' \
     --header 'authorization: Basic xxxx' \
     --header 'content-type: application/json' \
     --data '
{
  "payment_details": {
    "type": "paypay"
  }
}
'
				
			

次回の記事では、Webhookの設定と検証方法について詳しく解説しますので、お楽しみに!

Stay up to date

Sign up to receive the latest news to your email

Payment methods

All Payment Methods

日本の主要な決済方法を全て提供しています

韓国の主要な決済方法を全て提供しています

中国の3つの主要な決済方法を提供しています

ヨロッパーの主要な決済方法を提供しています