Frequently Asked Questions

What information am I guaranteed to obtain from a payment card?

The Triangle API guarantees the cardholder account number (PAN), redacted account number, expiry month, expiry year, card brand and either Track1 or Track2 data. The API provides further information (such as cardholder name, activation date of the card, etc.) if the data is present on the card, however the existence of this data on the card depends on the preferences of the party issuing the card.

What card brands and what devices does the Triangle API support?

Triangle works with Interac Flash, American Express ExpressPay, Visa PayWave and MasterCard PayPass enabled cards. The API is compatible with these cards globally and irrespective of the country where the card is issued. All Android devices with NFC sensors are currently supported by Triangle to scan payment cards. The API currently requires a minimum Android API target level of 14. If you need to use the API on an older build, please contact us for a custom build.

Is the cardholder information stored anywhere?

Triangle does not store cardholder information anywhere. The information provided by the API is captured in the PaymentCard class encrypted using keys unique to each application. This information is not sent to any other party (this can be validated by monitoring the network traffic when a card is scanned).

Under which circumstances can I use the Triangle API in my application but don't display the Triangle logo when a payment card is being scanned?

As indicated in our license, the usage of Triangle APIs is free for indie developers subject to the Triangle logo being displayed to the user when a payment card is being scanned. If you work for a company, or wish not to display the Triangle logo, you can contact us to discuss a custom license that meets your needs.

Can I charge a card using the Triangle APIs?

At this point, we don't have a public API that facilitates the exchange of funds from a payment card. If you are interested in this feature, please contact us.

How do I properly scan a card?

To scan a card, first ensure that:

  • The card supports NFC (it must be either PayPass, PayWave, ExpressPay or Flash)
  • Your device has an NFC sensor and that the NFC sensor is on
Second, hold the card close to the NFC sensor of your device. The NFC sensor's location depends on your phone, but the majority of handset manufacturers place the sensor on the back of the device close to the center of the battery. As a rule of thumb, stick your card parallel to the back of your phone to have it scanned.