• Register and provide Pass2U account.
• What kind of pass style you are using (e.g. coupon, loyalty, tickets...)?
• How to distribute the passes to your customers? (e.g., email, SMS, official websites, apps, facebook...)?
• Are you going to use Pass2U Checkout Service for redemption?

• Create a pass with custom data (e.g., ticket/card number, customer name, email, individual discount...).
• Update a pass with specified field changes.
• Distribute a pass through your own systems to customers (e.g., email, message, official website, app, facebook...).

1. Log in to Dashboard, and click Create a Model.

2. Click to select a style you want to distribute to your customers. The model’s style determines the overall dafault visual appearance of the passes.

3. On Model Designer page, you can quickly configure model appearance and the barcode type.
About field type, only "Dynamic" field can be customized (e.g. member name, email, Individual discount, points, balances...). In order to identify and customize this field via Pass API, the dynamic field should be named with a unique key. "Fixed field will use the same data on all passes. "Points" and "Credits" fields can’t be used via Pass API.

About barcode type, "Dynamic - assigned by CSV file or API (replicable)" or "Dynamic - assigned by CSV file or API (non-replicable)" can be used to specify barcode, "Dynamic - unique random 8-digit number" is used to generate unique 8-digit number barcode for every pass automatically by Pass2U system.

4. When you’re done, click Next until you issue the pass. The pass appears on the Issuing tab within dashboard and you will get the Model ID of the model.

• Only Dynamic fields can be given values. A field is configured to be "Dynamic" when design the model.

• If you don’t give data to fields, APIs will use the default data of the fields of the model.
• If you don’t give data to attributes of a field, APIs will use default attributes of the field of the model.
• If you give data for a field, APIs will set the data to the field and keep the field data as "customized". The field data will not be updated even if updating the model unless you use "Update pass" API to update the field.
• If you want to remove the "customized" data of the field and reset to the default field data of the model, please use "Delete custom field" API.
• If you give empty value to an attributes to a field (ex : "fields":[ {"key":"field1","value":""} ] "), APIs will give empty value to the attribute.

{
"expirationDate":"2018-12-31T23:00:15+08:00",
"foregroundColor":"rgb(51, 50, 46)",
"backgroundColor":"rgb(237, 219, 21)",
"labelColor":"rgb(196, 54, 39)",
"sharingProhibited":true,
"barcode":{
"message":"1234567890",
"altText":"1234567890"
},
"fields":[
{
"key":"name",
"value":"Fi-Lin,Chen"
},{
"key":"birth",
"value":"Dec’10 1999"
},
{
"key":"level",
"value":"GOLD"
}
],
"images":[
{
"type":"thumbnail",
"hex":"d33b9f1426d363340c2946557f173c402cd74014"
}
],
"locations":[
{
"latitude":25.0413093,
"longitude":121.55269329999999,
"relevantText":"Store nearby on 1st and Main."
},
{
"latitude":12.0413093,
"longitude":81.3226,
"relevantText":"Take a break with Bistro Coffee"
}
]}

{
"barcodeMessage":"1234567890",
"modelId":1919,
"passId":"VT-2I77F5ADz",
"createdTime":"2018-01-25T16:19:36+08:00",
"expirationDate":"2018-12-31T23:00:15+08:00"
}

{
"expirationDate":"2019-12-31T23:00:15+08:00",
"foregroundColor":"rgb(51, 50, 46)",
"backgroundColor":"rgb(211, 79, 46)",
"labelColor":"rgb(196, 54, 39)",
"fields":[
{
"key":"level",
"value":"DIAMOND",
"changeMessage":"You get highest and most rewarding level %@"
}
],
}

{
"barcodeMessage":"1234567890",
"modelId":1919,
"passId":"VT-2I77F5ADz",
"updatedTime":"2018-01-25T16:19:36+08:00",
"expirationDate":"2018-12-31T23:00:15+08:00"
}

none

none

none

none

none

• Supported : .png
• Maximum file size is: 4MB
• Maximum image dimensions are: 1024 px X 1024 px

{
"hex":"89b9a6edb1132bae969711230ef63e3fb367f34e"
}

                        {
                        "message":"error"
                        }