店頭決済（ロータス）
このページで扱うトピック
店舗側のシステムにて生成された固有のバーコードを店頭で表示するだけで、顧客はロータスでの店頭決済を簡単に行うことができます。
バーコードでのお支払いは、現在タイ国内、1800以上のLotus's （ロータス）各店でサポートされています。利便性の良い他のお支払い方法もこれから更に追加されていく予定です。こちらのサービスは、手数料として１０バーツを決済時に頂戴しております。
決済の流れ
顧客が決済確認画面に来ますと、配送先を入力し、ご注文内容をご確認いただいた後に、ご希望の決済方法をご選択いただけるようになります。ロータスでの店頭決済を希望される場合は、下記のように Lotus's (ロータス)を選択して下さい。
以下のように固有のバーコードが生成されますので、ロータス店舗カウンターでお支払いください。このバーコードの有効期限は２４時間となっています。
- バーコードの高さは1センチ以上としてください。
決済（ペイメント）ソースを使用し課金を作成する
課金を作成するには、ソースAPIを使用してソース対象（オブジェクト）を登録する必要があります。 ソースを作成するコードは以下の通りです。
curl https://api.omise.co/sources \
-X POST \
-u skey_test_59npyqikgqxtfqmfgq6: \
-d "amount=10025" \
-d "currency=thb" \
-d "type=bill_payment_tesco_lotus"
注意：入力する金額は4,900,000（タイバーツ）以下とする必要があります。
JSON Response
{
"object": "source",
"id": "src_test_59o3faxp9fn4fksdryb",
"type": "bill_payment_tesco_lotus",
"flow": "offline",
"amount": 10025,
"currency": "thb"
}
注意：ソース対象（オブジェクト）を作成するときは、シークレットキー、パブリックキーのいずれもご使用いただけます。
作成されたソースを取得します。最も重要な属性は、次に使用されるIDです。ここではidとして src_test_59o3faxp9fn4fksdryb があると仮定します。
課金を作成するには、課金APIで source パラメータとして渡します。
curl https://api.omise.co/charges \
-X POST \
-u skey_test_59npyqikgqxtfqmfgq6: \
-d "description=Charge for order 3947" \
-d "amount=10025" \
-d "currency=thb" \
-d "source=src_test_59o3faxp9fn4fksdryb"
次のように表示されます。
{
"object": "charge",
"id": "chrg_test_59o3j8ukevxlvj1vo5p",
"livemode": false,
"location": "/charges/chrg_test_59o3j8ukevxlvj1vo5p",
"amount": 10025,
"currency": "thb",
"description": null,
"metadata": {
},
"status": "pending",
"capture": true,
"authorized": false,
"reversed": false,
"paid": false,
"transaction": null,
"refunded": 0,
"refunds": {
"object": "list",
"from": "1970-01-01T00:00:00Z",
"to": "2017-10-18T06:25:08Z",
"offset": 0,
"limit": 20,
"total": 0,
"order": null,
"location": "/charges/chrg_test_59o3j8ukevxlvj1vo5p/refunds",
"data": [
]
},
"return_uri": null,
"reference": null,
"authorize_uri": null,
"failure_code": null,
"failure_message": null,
"card": null,
"customer": null,
"ip": null,
"dispute": null,
"created": "2017-10-18T06:25:08Z",
"source": {
"object": "source",
"id": "src_test_59o3faxp9fn4fksdryb",
"references": {
"omise_tax_id": "0105556091152",
"reference_number_1": "789164909013218240",
"reference_number_2": "437059934205645755",
"barcode": "https://api.omise.co/charges/chrg_test_59o3j8ukevxlvj1vo5p/documents/docu_test_59o3j8xlm2n5qew173e/downloads/6B5B4C0F8DE54221",
"expires_at": "2017-10-19T06:25:08Z"
},
"type": "bill_payment_tesco_lotus",
"flow": "offline",
"amount": 10025,
"currency": "thb"
}
}
エラーコード
| Code | Description |
|---|---|
bad_request |
金額は4,900,000（タイバーツ）以下としてください |
bad_request |
この通貨は現在サポートされていません |
bad_request |
こちらの様式は現在サポートされていません |
bad_request |
無効なソース |
not_found |
ソース source_id が見つかりませんでした |
Webhooks
Webhook APIを利用して顧客がトランザクションを完了すると、ダッシュボードのイベント名 charge.completeで指定されている特定URLにwebhookが送信されます。
属性source[type]を追加し課金を作成する
curl https://api.omise.co/charges \
-X POST \
-u skey_test_59npyqikgqxtfqmfgq6: \
-d "description=Charge for order 3947" \
-d "amount=10025" \
-d "currency=thb" \
-d "source[type]=bill_payment_tesco_lotus"
属性 source[type]を 追加して課金を作成することもできますが、決済ソースapiを使用して作成することをお勧めいたします。
注意
- Omise Thailandのライブアカウントご利用加盟店様は、 こちらのサービスをご利用頂く前に利用規約をご確認いただく必要がございます。お手数ですが、利用希望の旨をsupport@opn.ooo までご連絡ください。
