昨年の夏、Telegramは新しい支払い対応APIをリリースしました。 それ以来、メッセンジャーは、企業がクライアントと通信するだけでなく、商品やサービスの支払いをダイアログボックスで直接受け入れることを可能にする販売チャネルにもなりました。 Yandex.Kassaは、ロシアの決済サービスでこの機能をサポートした最初の企業です。 個々の起業家や小さな組織は、キャッシャーを通じてテレグラムへの支払いをすぐに受け入れました：花屋、紅茶とコーヒーショップ、トレーナー、トレーニングコースの主催者、慈善団体、その他多数 （ ここでレビューと例を読むことができます）。 しかし、注文の流れがある大企業には、1つのストッパーがありました。

事実、最近まで電報販売には、電子商取引のロシア語のみの仕様を考慮に入れていない機能が1つありました-オンライン小切手の強制送信（要件54-FZ、 オンラインキャッシュデスクに関する法律として知られています ）。 Yandex.Kassaはすぐに、新しいレジ装置での作業をサポートし、小切手の転送を自動化する特別なプロトコルを作成しました。 しかし、Telegramでは、そのような自動化は技術的にサポートされていなかったため、売り手は小切手の送信を自分でセットアップする必要がありました（タンバリンと踊ることを検討してください）。 そして最近、メッセンジャーはロシアの電子商取引市場に向かい、Yandex.Cashとの共同プロジェクトを実施し、そのプロトコルに重要な要素を追加しました-支払いプロバイダーへの追加情報のための特別なフィールドが登場しました。 顧客サービスだけでなく、オンラインチェックの転送の自動化（つまり、54-FZへの準拠）の観点から、Telegramを介して販売するのが便利になりました。 カットの下で、Yandex.Cashを介して支払いを受け入れ、Telegramで販売を開始するために必要なことを説明します。

Telegramでの支払いプロセスはどのように見えますか

メッセンジャーで何かを購入する必要がなかった場合、販売シナリオは明らかではないかもしれません。 場合によっては、販売はサイトで開始され、Telegramで終了します。 その他では、すべての顧客サービスはTelegramボットを経由します。 手順を追って説明します。

1. バイヤーは商品をストアのウェブサイトのバスケットに入れ、支払い段階でテレグラム経由で支払うことを選択します（2番目のオプションは、クライアントが最初にテレグラムボットを使用して製品またはサービスを選択する場合です。次の図のようなシナリオを検討します）。
2. 店舗のボットは顧客に請求します。
3. テレグラムは、支払いボットYandex.Cashと請求書に関する情報を交換します。
4. 支払人は、Telegramアプリケーションを終了せずに支払い情報を入力します。
5. Bot Y. Kassiは支払いを行い、ストアとTelegramのバックエンドに支払いが成功したことを通知します。
6. 電報は支払人とボットに店舗を通知します。

言うまでもなく、段落の実行速度。 1-2は、クライアント（商品の選択、支払い情報の入力）、および段落からのプロセスに依存します。 3-6はほとんど瞬時に起こりますか？

ロシア語サービスで支払いボットを使用する例“ You can do it！”（@UchenyjBot）

Telegramを介して販売を設定する方法

Telegramが支払いサポート付きのAPIをリリースしたばかりのとき、この販売チャネルは、ユーザーと通信する店舗のすべてのシナリオを考慮して、独自のボットを作成できる中規模および大規模な商人の間で需要があるように見えました。 しかし実際には、彼はTelegramで大きな小売店を売っていませんでしたが、小さなサービス会社と小さな店が来ました。

Yandex.Cashを介してTelegramで販売を設定するには、3つの主なことを行う必要があります。

1. Yandex.Checkoutで登録します。契約に署名し、ストアID（shopId）を取得します。
2. 顧客と通信するTelegramボットを作成します。 すべてのボットは@Botfatherを介して作成されますが、それらの動作は独立して、またはコンストラクターを介してプログラムできます。 完成したボットは、@ BotFatherとのチャットを介してアクティブ化する必要があります。
3. ボットをYandex.Kassi支払いボットに接続します 。 これを行うには、ボットのメニューの[支払い]タブで、BotFatherとのダイアログで、支払いプロバイダーとしてYandex.Cashを選択します。 次に、/ startを介して新しいボットとのダイアログを開始し、Yandex.CashアカウントアカウントからshopIdを指定し（商人が接続されたときに割り当てられ、それぞれに独自のアカウントがあります） 、Telegram payment APIからsendinvoiceメソッドを実装します 。 ボットが設定されると、支払いの受け入れは自動的にオンになります。

要求に応じて、ボットは支払い請求書をクライアントに送信します。 請求書には、費用、名前、商品の説明、ペイロードパラメータ、およびprovider_tokenパラメータが含まれている必要があります。これは、@ BotFatherが発行したトークンと同じです。

バイヤーから配送先住所を取得する必要がある場合は、Shipping Queryメソッドを実装します。 ユーザーが住所を指定すると、このリクエストはanswerShippingQueryメソッドによって応答され、配信メソッドとその価格に渡される必要があります。

したがって、小切手を送信することを除いて、ほとんどすべての準備が整います。

54-FZでの電報による販売

最近まで、商人はボットを介して販売を監視し、独自に会計処理を実行する必要がありました。 これは実際にはどういう意味ですか？ これは、販売がオフラインになった場合と同じです。ボットは販売に関する通知を販売者に送信し、販売者は販売されたすべての商品を手動でキャッシュデスクに送り、支払い前に購入者が残した連絡先に小切手を渡しました。

Telegramのフレームワーク外で、Yandex.Kassaはサービスとして、すべての人気のあるサプライヤーの70を超えるKKMモデルのオンライン支払いに関するデータを自動的に転送することができました。 しかし、Kassaのキャッシュデスクには、ボットがマーチャントボットから受信できるデータのサイズに制限があるため、そのような機能はありませんでした。 Telegramが支払いボットのプロトコルを完成させた2月にすべてがうまくいきました。支払いプロバイダーに追加情報を提供するフィールド-プロバイダーデータが表示され、この機会を自宅で実感しました。 このフィールドは、チェックの構成に関するデータを送信するために必要です。 Y. Kassaはこのフィールドを解析する方法を知っているので、商人は自分のボットを正しく設定するだけで、チェックの構成に関するデータを追加できます。

以下は、チェックが添付されていない、つまり2月までのリクエストコードです 。

{ "chat_id":147426403, "title": "Test", "description": "Test", "payload":{}, "provider_token":"390540012:LIVE:1514", "currency": "RUB", "start_parameter":"mybot", "prices":[{"label":"-","amount": 6100}] }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

さらなる処理と会計処理のために小切手の構成に関する情報を追加すると、Yandex.Kassi支払いボットの追加情報を含む請求書を送信するためのTelegramへの要求は次のようになります（ Receiptフィールドへの注意は小切手の構成です ）：

 { "chat_id":147426403, "title": "Test", "description": "Test", "payload":{}, "provider_token":"390540012:LIVE:1514", "currency": "RUB", "start_parameter":"mybot", "prices":[{"label":"-","amount": 6100}], "provider_data":{ "receipt":{ "email":"example@example.com", "items":[ { "description": " A", "quantity": "1.00", "amount": { "value": "100.00", "currency": "RUB" }, "vat_code": 1 } ] } } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

リクエストの必須データから：

• need_phone_numberまたはneed_email-アカウントをクリックした後、電話番号（need_phone_number）および/または電子メール（need_email）を要求する必要があることをTelegramに伝えます。
• send_email_to_provider （購入者にメールをリクエストした場合）またはsend_phone_number_to_provider（電話番号をリクエストした場合）-入力した値を支払いプロバイダーに送信する必要があることを示します。
• provider_dataと領収書オブジェクト -領収書には、商品アイテムまたはサービス、それらの数量と価格のリストが含まれている必要があります。 すべてが定期的なチェックのようです。

Ya.KassaがTelegramでの支払い後、購入者が小切手を送信する必要があることをレジに自動的に「通知」するには（小切手自体がレジにサービスを提供するOFDを送信します）、以下を実行する必要があります。

1. Y.Kassaの個人アカウントで、Yandex.Kassaと互換性のあるレジの設定を示します（現在、Kassaは、Atol and Atol Online、Orange Data、UMKA、StarRus、Evotor、Dreamkas、Iskra、Shtrikh-M、 Accountmash、Incotexなど）。
2. Telegramボットがまだない場合は、 作成して 、 この手順を使用してYandex.Kassiボットに接続します 。

支払いボットの作成経験がある場合、または支払いの設定方法について質問がある場合は、コメントしてください。