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

keyTypeRequiredDescription
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