スマレジAPIでの取引について質問です。

カテゴリ: POS

スマレジAPIでの取引について質問です。


下記運用の想定をしておりますが、下記運用を実現するスマレジAPIはございますでしょうか?

①他のWEBシステムで発行したQRコードに精算金額情報を付与し、

 そのQRコードをスマレジで読み込む


②上記①の金額をユーザーが支払う


③支払が完了すると、他のWEBシステムにスマジレAPIより決済完了のcallbackを受け取る


▪️必要API

1、他システムの操作から、スマレジに精算金額を送るAPI

2、支払完了すると、他のWEBシステムにスマジレAPIより決済完了の結果をcallbackするAPI


よろしくお願いします。

答え

  • @tueda

    取置き機能もしくは仮販売機能が運用にあっているかと思います。

    下記それぞれのヘルプサイトになりますのでご確認ください。

    ・取置き販売をする:https://help.smaregi.jp/hc/ja/articles/202423876

     API:https://www1.smaregi.dev/apidoc/#operation/createLayaway

    ・取引を仮登録する(仮販売):https://help.smaregi.jp/hc/ja/articles/217327597

     API:https://www1.smaregi.dev/apidoc/#operation/createTemporaryTransaction


    お会計後は取引のWebhookにてご確認ください。

    仕様書:https://www1.smaregi.dev/apidoc/#operation/webhook-transactions

  • ありがとうございます


    ちなみになのですが、他のWEBシステムで発行したQRコードをスマレジで読み込ませると

    自動的にスマレジの精算画面に遷移し、精算させる動きはできませんでしょうか?


    また、東本様の方法は下記認識であっておりますでしょうか?

    ①仮販売APIにて、精算金額を登録する

    ②レスポンスとして、バーコードを受け取る

    ③そのバーコードを携帯画面に表示させ、スマレジでバーコードを読み取る

    ④読み取ったバーコードからスマレジで精算

    ⑤精算完了すると、webhookにて取引完了の確認

  • @tueda

    基本的には記載の流れでお会計を行うとよいかと思います。


    ちなみになのですが、他のWEBシステムで発行したQRコードをスマレジで読み込ませると

    自動的にスマレジの精算画面に遷移し、精算させる動きはできませんでしょうか?

    こちらは、記載の流れのどの部分をどのような操作に変更したいのでしょうか。

  • 返信ありがとうございます

    >こちらは、記載の流れのどの部分をどのような操作に変更したいのでしょうか。

    ①,②の箇所になります

    独自QRコードに精算金額の情報を乗せた物を用意し、スマレジにてQRを読み取ると

    そのままユーザーが精算できるようにしたいと考えておりました

  • @tueda

    商品であればNON-PLU機能がご利用いただけるかと思いますが、

    スマレジに登録されていないお会計情報が含まれたQRコードにてお会計を行うことは出来かねます。


    事前に仮販売データや取置きデータとして登録する必要があります。

  • ありがとうございます


    続けてのご質問で恐縮なのですが、

    精算完了すると、仮販売webhookにて取引完了の通知がエンドポイントに送られると思うのですが

    もし、他システムのサーバーがダウン等しており、webhookが送れなかった場合

    スマレジの挙動はどうなりますでしょうか?(精算完了になる/ 精算完了にならずもう一度精算してもらう)

  • 五月雨式になり申し訳ございません


    質問があります

    ①仮取引にて取得したバーコードを使い回すことは可能になりますでしょうか

    ②前回ご質問させていただきましたQRを使った精算なのですが、

     商品登録APIを利用して実現可能でしょうか?

     また、商品コードで作成したQRコードは使い回し可能でしょうか

    ①商品登録APIにて、商品並びに精算金額を登録する

    ②レスポンスとして、商品コードを受け取る

    ③その商品コードをQRにし携帯画面に表示させ、スマレジでQRコードを読み取る

    ④読み取ったQRからスマレジで精算

    ⑤精算完了すると、webhookにて取引完了の確認

  • 10/17にお送りした質問はトピックが違うので、トピックを立てさせていただきます

  • @tueda

    スマレジ側の挙動はWebhookの通知状況に影響されません。


    Webhookにつきましては、お会計が完了し取引が立ったタイミングで通知され、

    そこでなにかエラーが発生したからといって、取引がキャンセルされることはございません。