Integration Guide

Basic information

Onewallet URL Scheme starts with onewallet://, as shown in the following URL structure.

You can specify the type of feature in actionPath, and required parameters for each feature in code={JSON DATA}. Refer to the description of parameters for each feature, for more information.

Add Card

Go to the automatically added card addition screen.

Action path

input?code={JSON DATA}

JSON Key

Property description

key
Type
Required
Description

String

Code number (value used when creating barcode or QR code)

Int

Wallet Type (0 = Normal (points, membership, coupon, gift card, etc.), 1 = Boarding Pass, 2 = Card) Design varies depending on type

String

BarcodeType [CODE_128, CODE_39, CODE_93, PFD_417, etc.] Type of barcode format

String

QRType [AZTEC, DATA_MATRIX, QR_CDOE, etc.] QR code format type

String

Logo Image Url, representative image information

Int

RGB(666666) or ARGB(FF666666) Integer Value, background color information to be used on the card

String

Title

String

SubTitle

String(jsonString)

Space for additional information at the top. Two designs are supported for each wallet type. If walletType is 0(Normal), 1(Boarding Pass), only the value value is used and two spaces are supported. { "key1":"{title1}", "value1":"{value1}", "key2":"{title2}", "value2":"{value2}" } If walletType 2 (Card), the card's name, valid date, and cvc space are supported. { "name":"{card name}", "vaild_date":"{valid}", "cvc":"{cvc or cvv}", }

String(jsonString)

Only WalletType 1 (Boarding Pass) is supported, and space for additional information at the bottom. Only value information is used. { "key1":"{title1}", "value1":"{value1}", "key2":"{title2}", "value2":"{value2}", "key3":"{title3}", "value3":"{value3}", "key4":"{title4}", "value4":"{value4}", "key5":"{title5}", "value5":"{value5}", "key6":"{title6}", "value6":"{value6}" }

String

Additional information that cannot be included

Long

Specify expiration time as Timestamp and milliseconds

Example

Normal Type

{ 
  "backgroundColor":-14649096,
  "code":"1234567890",
  "codeType":"CODE_128",
  "logoUrl":"https://lh3.googleusercontent.com/5MlRrSa9Wm47Ig9kd9mDD9J3ekq_Pj1LXqeEJ3korTCsrc2d68HBWJYNYs6_p_fMBw\u003ds128-rw",
  "memo":"memo",
  "qrType":"QR_CODE",
  "subtitle":"desc",
  "title":"title",
  "walletType":0
}

Boarding Pass Type

{ 
  "backgroundColor":-12547848,
  "code":"1234567890",
  "codeType":"CODE_128",
  "expiredDate":1574953200000,
  "extend1":"{\"key1\":\"NYC\",\"value1\":\"New Yock City\",\"key2\":\"SFO\",\"value2\":\"San Francisco\"}",
  "extend2":"{\"key1\":\"Seat\",\"value1\":\"22A\",\"key2\":\"Flight\",\"value2\":\"475A\",\"key3\":\"Gate\",\"value3\":\"40A\",\"key4\":\"Boarding\",\"value4\":\"11:00 AM\"}",
  "logoUrl":"https://lh3.googleusercontent.com/rFdhVrgK0CY6dUL9wKIRIv2BU-fXnO7lNMbdHTRUk02tXuU6N1JlVJLTs9HwAE6tZ4Q\u003ds128-rw",
  "memo":"Memo",
  "qrType":"QR_CODE",
  "subtitle":"03 Feb",
  "title":"Passenger",
  "walletType":1
}

Card Type

{ 
  "backgroundColor":-12547848,
  "code":"34534534534567887",
  "codeType":"CODE_128",
  "extend1":"{\"name\":\"CARD HOLDER\",\"vaild_date\":\"01/20\",\"cvc\":\"123\"}",
  "logoUrl":"https://lh3.googleusercontent.com/rFdhVrgK0CY6dUL9wKIRIv2BU-fXnO7lNMbdHTRUk02tXuU6N1JlVJLTs9HwAE6tZ4Q\u003ds128-rw",
  "qrType":"QR_CODE",
  "subtitle":"VISA",
  "title":"Credit Card",
  "walletType":2
}
image