GoNative

The GoNative Developer Hub

Welcome to the GoNative developer hub. You'll find comprehensive guides and documentation to help you start working with GoNative as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Card.io

Overview

Simplify payment form completion using the device camera and machine vision to read any credit card. Hold your card in front of the card to capture cardholder name, card number, and expiry date without typing.

The Card.io module improves customer conversion by simplifying the payment process. All machine vision image processing is performed locally on the device, thus sensitive cardholder information remains secure within your website.

Formerly a commercial pay-for-use SDK, Card.io is now open source supported by PayPal. Therefore there are no additional licenses or ongoing fees to use this module.

Implementation Guide

Once the premium module has been added to your app, you may use the following GoNative JavaScript Bridge commands to access its functionality.

Scanning a card

To scan a credit card, define a function in javascript, for example:

function processCard(data) {
  alert(JSON.stringify(data));
}

️GoNative JavaScript Bridge

To initiate a scan, open the url:

window.location.href = 'gonative://card.io/scanCard&callbackFunction=processCard';

Scanning options

Optional query params include:

  • requireExpiry: default true. Get the expiry date.
  • scanExpiry: default true. Attempt to automatically determine the expiry date.
  • requireCVV: default true. Get the CVV of the card.
  • requirePostalCode: default false. Get the postal code of the cardholder.
  • numericPostalCode: default false. Set to true if you know the postal code must be numeric.
  • requireCardholderName: default false. Get the cardholder's name.
  • useCardIOLogo: default false. Show card.io logo instead of Paypal logo. Obviated if hideCardIOLogo is true.
  • hideCardIOLogo: default true. Hide the logo from the UI.
  • instructions: a custom instruction string to show on the UI. Card.io provides a default string.

️GoNative JavaScript Bridge

For example, if you know the postal code must be numeric and to get the postal code of the cardholder, initiate a scan by opening the url:

window.location.href = "gonative://card.io/scanCard?callbackFunction=processCard&requirePostalCode=true&numericPostalCode=true";

Scanning result

On a successful card scan, the callback function will be called with a javascript object as it's parameter. The object may have the following fields:

  • cardNumber: (string)
  • cardholderName: (string)
  • expiryMonth: (number)
  • expiryYear: (number)
  • cardType: (string) "visa", "mastercard", "amex", "discover", or "jcb"

Updated 2 months ago

Card.io


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.