Gateway / Payment Screen

Sparkbooth's Gateway Screen feature can be used to take payments, answer surveys, or require other input from your guests before starting the session or printing the photo layout. You will need to have a web server to display an HTML page in the screen to take the payment or other actions.

Sparkbooth-gateway.jpg

Sparkbooth-gateway-config.jpg

  • Enable Gateway Screen if checked will display the screen.
  • Selecting Before Starting will display the screen at the beginning of the session. If the payment or other action is successful, the guest will continue into the session and Sparkbooth will start taking photos. If the payment or other action is canceled or fails, it will go back to the starting screen and wait for the next guest.
  • Selecting For Printing will display the screen before printing the photo layout. If the payment or other action is successful, it will print the photo layout. If the payment or other action is canceled or fails, Sparkbooth skips the printing.
  • Gateway Title is the text displayed at the top of the screen
  • Gateway Cancel is the text used for the cancel button label
  • Start URL is the url that the screen displays. You can pass a number variables in the url:
    • {id} is a random value to uniquely identify the session
    • {booth} is the photo booth name that you set under Settings > Premium > Notifications to identify the specific booth
    • {prints} is the number of prints that will be printed if you are using the screen to take a payment before printing. Use this to calculate the total price for per print pricing.
    • {buying} can be "session" or "printing" to indicate the reason for the payment.
  • Success URL is the url that the web page will change to if payment or other action is successful. When the page changes to this url, Sparkbooth will start the session or print the photo layout
  • Failure URL is the url that the web page will change to if payment or other action fails. When the page changes to this url, Sparkbooth will cancel the session or skip the printing
  • Cancel URL (optional) is the url that Sparkbooth will ping if the cancel button is pressed. Use this to let the server know to cancel the payment.
  • URL Match is how the success and failure urls are matched. Entire means the URLs must match from beginning to end of the page URL. Beginning means the URLd must match the beginning of the page URL. Any Part means the page URLs can match any part of the page URL.

Example of workflow for successful payment

Sparkbooth_payment_flow.png

Example of workflow for failed payment

sparkbooth_payment_failure.png

Example of workflow for pressing cancel button

sparkbooth_payment_cancelled.png

Example using Jotform online survey

Here is a online survey created on Jotform. You can use this survey to have guests answer an online survey before starting the photo booth.

In the Gateway screen settings, use:

Sparkbooth-gateway-jotform.jpg