App Linking

Introduction

Zapper App Linking allows your users to pay quickly and easily, by tapping a link and opening the Zapper app on the payment screen, using your merchant and transaction details.

Example

https://www.zapper.com/payWithZapper?qr=http%3A%2F%2F2.zap.pe%3Ft%3D4%26i%3D1%3A1%3A7%5B34%7C50.00%7C11%2C33%7CORD-001%3A10%5B38%7CMy%20Merchant%20Name%2C39%7CUSD&appNameAcme%20Inc

The structure of the app link must be:

https://www.zapper.com/payWithZapper?qr={zapperCodeString}&appName={appName}&successCallbackURL={callbackURL}

Property

Description

zapperCodeString

A URL encoded version of your Zapper Code string. i.e. the decoded Zapper QR Code.

appName

A URL encoded version of the referral application name.

callbackURL (optional)

The URL you would like to be opened once the payment has been completed. This will be triggered upon successful OR declined payments.

​

This scheme of this URL must be either http or https.

Zapper Code string

The Zapper Code string must be populated with your relevant merchant and transaction information. Once complete, this string must be URL encoded and included in your app link.

Structure

http://2.zap.pe?t=6&i={merchantId}:{siteId}:7[34|{amount}|{amountType},33|{merchantReference}|10,60|1:10[38|{merchantName},39|{currencyIsoCode}

Property

Description

merchantId

Your Zapper merchant ID.

siteId

Your Zapper site ID.

amount

The amount of the transaction in decimal format e.g. 99.50.

amountType

Whether or not the amount is read-only or editable by the user. If it is read-only, set this value to 11. If you would like the user to be able to edit the amount, remove "|{amountType}" from the template above (including the " | " character).

merchantReference

The reference used by the merchant to link the payment back to an internal order.

merchantName

Trading name visible to the user before the Zapper app has retrieved live merchant information.

currencyIsoCode

ISO Code for the currency of the transaction to be visible to the user before the Zapper app has retrieved live merchant information.