Get started with payments in Outlook

The purpose of this guide is to walk through the process of setting up one of our sample payment services and testing some mock payment scenarios.

Prerequisites

  • An Office 365 subscription with Exchange Online. If you don't have an existing subscription, you can signup for a 25-user free trial of the Office 365 Business subscription.
  • A Microsoft account (MSA) to receive the test payment request. If you don't have a Microsoft account, you can sign up for one for free.
  • A Stripe connect platform account. If you don't have an account, you can sign up for one on their website.

Download a sample service

Choose on of the following sample services to get up and running quickly. Refer to the README file in your project of choice for specifics on building and running the sample.

Register your service

Once you have one of the samples running, the next step is to register the webhook URLs with the payment service so that requests get routed to the sample. Refer to the README for your sample of choice for the specific URLs to use.

Follow the instructions in the payments in Outlook partner dashboard guide to link your Stripe account and register your webhook URLs. Be sure to copy the message card payload generated by the dashboard for the next step.

Important

If you are using a free ngrok account to run the sample locally, the URL used by ngrok changes each time you run the ngrok tool. If you stop ngrok and restart it, you will need to revisit the payments in Outlook Dashboard and update your webhook URLs.

Send the test payment request

  1. Go to the MessageCard Playground.
  2. Paste in the Message Card Payload generated by the dashboard.
  3. Choose Send via email.
  4. Sign in with your Microsoft account. You should get confirmation that the message was sent successfully.

Test the solution

  1. Login to Outlook.com using your Microsoft account and find the message you sent from the MessageCard Playground.

    The message sent by the MessageCard Playground

  2. Choose the Review & Pay button to open the payment pane. Your payment request webhook should receive a loadentity payload.

Refer to the README for your sample of choice for further steps to test the payment experience.