Skip to main content
POST
QRコード決済の作成(PayNow)

主なポイント

加盟店の設定
  • **加盟店ID(Merchant ID)**は、選択したQRコード決済方法に対応するように設定されている必要があります。
  • PayNowを利用する場合、payment_method の type に paynow を指定する必要があります。
  • PayNowのリクエスト例では、処理通貨として**SGD(シンガポールドル)**を使用しています。
QRコードの生成
  • Direct Payment APIは、顧客が決済を行うためのQRコードデータを生成します。
  • PayNowの場合、レスポンスの url.qrCode にBase64エンコードされたQRコード画像が、url.data に対応するQR決済データが含まれます。
  • 加盟店は生成されたQRコードを顧客に表示し、対応する銀行アプリケーションでスキャンして決済できるようにします。
  • QRコードが生成された時点では、決済の完了を意味しません。

承認

Authorization
string
header
必須

認証用のAPIキー。形式:「Basic YOUR_API_KEY_HERE」

x-api-key
string
header
必須

x-api-keyヘッダー専用のAPIキー。

ボディ

application/json

PayNowのダイレクト決済リクエスト。請求先住所は必須、配送先住所は任意です。

amount
string
必須

文字列形式で指定する取引金額。

例:

"200"

currency
string
必須

決済処理通貨(このPayNowの例ではSGD)。

Maximum string length: 3
例:

"SGD"

payment_method
object
必須

決済方法の詳細を含むJSONオブジェクト。

merchant_txn_ref
string
必須

加盟店の取引参照ID。

Maximum string length: 45
例:

"TEST00989012878787878787878787"

customer_ip
string
必須

取引を開始する顧客のIPアドレス。

例:

"124.219.163.171"

merchant_id
string
必須

加盟店の一意の識別子(DASMID)。

Maximum string length: 128
例:

"SG00003085"

return_url
object
必須

取引のコールバックURLおよびリターンURL。

billing_address
object
必須

顧客の請求先住所(必須)。

shipping_address
object

配送先住所(任意)。リクエストから省略できます。

time_zone
string

取引のタイムゾーン。

例:

"Asia/Tokyo"

レスポンス

200 - application/json

QRコード決済が作成され、QR決済データが返されました。これは決済完了を意味しません。

id
string

取引参照ID。

例:

"cd3c8f8c-75ec-4d63-a90d-10046616c5da"

url
object

生成されたQR決済データ(チェックアウトURLではありません)。

amount
integer

取引金額。

例:

200

currency
string

決済処理通貨。

例:

"SGD"

merchant_txn_ref
string

加盟店の取引参照ID。

例:

"TEST00989012878787878787878787"

merchant_id
string

取引の加盟店ID。

例:

"SG00003085"

merchant_email
string | null

加盟店のメールアドレス(取得できる場合)。

例:

null

return_url
object

決済コールバック用のリターンURLの詳細。

billing_address
object

請求先住所の詳細。

shipping_address
object

配送先住所の詳細。指定されていない場合は空のオブジェクトになることがあります。

redirecturl
object

QR決済データはredirecturlにも含まれます(通常のリダイレクトURLではなくオブジェクトです)。