店頭決済(ロータス)

このページで扱うトピック
こちらのページにてご案内の「店頭決済(ロータス)」に関するサービスは、現在Omise Thailandご契約加盟店様のみご利用いただけます。その他の国でOmiseをご利用中の加盟店様には誠に恐縮ですが、ご提供開始まで今しばらくお待ちください。

店舗側のシステムにて生成された固有のバーコードを店頭で表示するだけで、顧客はロータスでの店頭決済を簡単に行うことができます。

バーコードでのお支払いは、現在タイ国内、1800以上のLotus's (ロータス)各店でサポートされています。利便性の良い他のお支払い方法もこれから更に追加されていく予定です。こちらのサービスは、手数料として10バーツを決済時に頂戴しております。

決済の流れ

顧客が決済確認画面に来ますと、配送先を入力し、ご注文内容をご確認いただいた後に、ご希望の決済方法をご選択いただけるようになります。ロータスでの店頭決済を希望される場合は、下記のように Lotus's (ロータス)を選択して下さい。

Bill payment flow

以下のように固有のバーコードが生成されますので、ロータス店舗カウンターでお支払いください。このバーコードの有効期限は24時間となっています。

Bill payment flow 2

- バーコードの高さは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 までご連絡ください。

Omiseは、お客様のウェブサイト全般における利便性を向上するためにクッキーを利用し、お客様のアクセス、閲覧履歴に関する情報を収集します。 当社のウェブサイトを閲覧し続けることにより、お客様は当社のプライバシーポリシーに同意することとします。 詳細はこちら