ソースの作成

POSThttps://api.omise.co/sources

代替決済手段用の決済ソースを作成します。ソースを使用することで、PromptPay QRコード、モバイルバンキング、インターネットバンキング、分割払いなどでの支払いが可能になります。

---

リクエストパラメータ

必須 - 3項目必須パラメータ

▼

`amount`INTEGER(required)

最小通貨単位での金額（THBの場合はサタン、USDの場合はセント、JPYの場合は円）。例：100000サタン = 1,000 THB。

Example:100000

Constraints:最小値: 決済手段により異なる, PromptPayの最小値: 20 THB（2000サタン）

`currency`STRING(required)

ISO 4217形式の3文字通貨コード（小文字）。決済手段タイプと一致する必要があります。

Example:"thb"

Values:thb, jpy, sgd, myr

`type`STRING(required)

決済手段タイプ。タイプによって対応通貨が異なります。

Example:"promptpay"

Values:promptpay, paynow, alipay, alipay_cn, alipay_hk, dana, gcash, kakaopay, touch_n_go, boost, shopeepay, shopeepay_jumpapp, maybankqrpay, duitnow_qr, promptpay_credit, wechat_pay, rabbit_linepay, truemoney, fpx, mobile_banking_scb, mobile_banking_kbank, mobile_banking_bbl, mobile_banking_bay, mobile_banking_ktb, internet_banking_scb, internet_banking_bbl, internet_banking_bay, installment_bay, installment_first_choice, installment_bbl, installment_kbank, installment_ktc, installment_scb, installment_ttb, installment_uob, installment_mbb, installment_krungsri, econtext, payeasy, netbanking, paypay, atome

推奨 - 2項目推奨パラメータ

▼

追加 - 15項目追加パラメータ

▼

---

レスポンス

200

取引成功

ソースが正常に作成されました。レスポンスにはQRコードやリダイレクトURLなどの決済固有のデータが含まれます。

主なレスポンスフィールド:

• id - チャージ作成時に使用するソースID（src_*）
• type - 決済手段タイプ
• flow - 決済フロー：offline（QRコード）、redirect（Web）、またはapp_redirect（モバイルアプリ）
• amount - 最小通貨単位でのソース金額
• currency - 通貨コード
• scannable_code - QRベース決済用のQRコードデータ
• charge_status - このソースで作成されたチャージのステータス
• created_at - ソース作成タイムスタンプ（ISO 8601）

400

不正なリクエスト

リクエストの検証に失敗しました。詳細はエラーメッセージを確認してください。

主な原因:

• 必須フィールド（amount、currency、type）が不足
• 決済タイプに対して無効な通貨（例：PromptPayにSGD）
• タイプ固有の必須フィールドが不足（例：分割払いのinstallment_term）
• 無効な決済タイプ

401

認証エラー

認証に失敗しました。APIキーが無効または不足しています。

主な原因:

• Authorizationヘッダーが不足
• 無効な公開キー
• 公開キーの代わりに秘密キーを使用
• HTTP Basic Auth形式が正しくない

422

処理不能なエンティティ

ビジネスロジックの制約によりリクエストの検証に失敗しました。

主な原因:

• 決済タイプの最小金額を下回っている
• 決済タイプの最大金額を超えている
• アカウントで決済タイプが有効化されていない
• 選択した銀行に対して無効な分割払い期間

5xx

サーバーエラー

サーバー側でエラーが発生しました。まれなケースですが、適切に処理する必要があります。

対処方法:

• 指数バックオフでリクエストを再試行
• status.omise.coでサービスインシデントを確認
• 詳細なガイダンスはエラー処理を参照

---

コードサンプル

cURL

curl https://api.omise.co/sources \
  -u pkey_test_5xuy4w91xqz7d1w9u0t: \
  -d "amount=100000" \
  -d "currency=thb" \
  -d "type=promptpay"

Ruby

require 'omise'

Omise.api_key = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = Omise::Source.create({
  amount: 100000,
  currency: 'thb',
  type: 'promptpay'
})

Python

import omise

omise.api_public = 'pkey_test_5xuy4w91xqz7d1w9u0t'

source = omise.Source.create(
    amount=100000,
    currency='thb',
    type='promptpay'
)

Node.js

const omise = require('omise')({
  publicKey: 'pkey_test_5xuy4w91xqz7d1w9u0t'
});

const source = await omise.sources.create({
  amount: 100000,
  currency: 'thb',
  type: 'promptpay'
});

PHP

<?php
define('OMISE_PUBLIC_KEY', 'pkey_test_5xuy4w91xqz7d1w9u0t');

$source = OmiseSource::create([
    'amount' => 100000,
    'currency' => 'thb',
    'type' => 'promptpay'
]);

Java

Client client = new Client.Builder()
    .publicKey("pkey_test_5xuy4w91xqz7d1w9u0t")
    .build();

Source source = client.sources().create()
    .amount(100000L)
    .currency("thb")
    .type("promptpay")
    .send();

C#

var client = new Client("pkey_test_5xuy4w91xqz7d1w9u0t");

var source = await client.Sources.Create(new CreateSourceRequest
{
    Amount = 100000,
    Currency = "thb",
    Type = "promptpay"
});

Go

client, _ := omise.NewClient(
    "pkey_test_5xuy4w91xqz7d1w9u0t",
    "",
)

source, _ := client.Sources().Create(&operations.CreateSource{
    Amount:   100000,
    Currency: "thb",
    Type:     "promptpay",
})

---

エラーコードと結果コード

一般的なエラーコード

コード	説明	解決方法
bad_request	パラメータが不足または無効	すべての必須フィールドが指定されているか確認
authentication_failure	無効なAPIキー	公開キーが正しいか確認
currency_not_supported	決済タイプで通貨がサポートされていない	決済タイプが通貨をサポートしているか確認
amount_too_low	金額が最小値を下回っている	決済タイプの最小金額を確認
amount_too_high	金額が最大値を超えている	決済タイプの最大金額を確認
payment_method_not_allowed	決済タイプが有効化されていない	Omiseに連絡して決済手段を有効化

ソースフロータイプ

フロー	説明
offline	顧客がQRコードをスキャン（PromptPay、Alipay）
redirect	顧客がWebページにリダイレクト（インターネットバンキング）
app_redirect	顧客がモバイルアプリにリダイレクト（モバイルバンキング）

---

🔑API認証情報

▼

試してみる

必須 - 3項目

▼

amount(必須)

currency(必須)

type(必須)

推奨 - 2項目

▼

追加 - 15項目

▼

あなたのIP: ...読み込み中...