(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start': new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0], j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.data-privacy-src= 'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f); })(window,document,'script','dataLayer','GTM-P2BC6Q6N');

Help Center

Wallet Postback

This section can be used as a reference for Wallet Postback notifications when the following situations occur: pass was generated successfully, pass failed to generate, pass was installed or uninstalled on Apple Wallet or Google Pay, pass data has been updated via API/Web, pass has been updated on the app.

Notification Examples #

1. Response: Pass Generation Success

{  
    "origin":"wallet",
    "status-code":"N801",
    "status-text":"Generated",
    "status-details":"Pass generated successfully",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"Store-78912",
    "tracking-id":"xxxxxxxxxx",
    "timestamp":"2018-11-23T06:27:28+00:00"
}

2. Response: Pass Generation Failure

{  
    "origin":"wallet",
    "status-code":"N802",
    "status-text":"Failed",
    "status-details":"Failure reason/details",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"Store-78912",
    "tracking-id":"xxxxxxxxxx",
    "timestamp":"2018-11-23T06:27:28+00:00"
}

3. Response: Pass Installation for Apple Wallet

{  
    "origin":"wallet",
    "status-code":"N804",
    "status-text":"Installed",
    "status-details":"Pass Installed on the App",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"1618389328-5c1b63d9d527d",
    "timestamp":"2018-12-20T09:59:55+00:00",
    "app-type":"Apple Wallet",
    "install-id":"d04d58f636b245d5"
    "reference-data": {
 	"email": "fake.email@email.com",
 	"phone": "10000000000",
 	"transaction-id": "96"
 	              }
}

4. Response: Pass Installation for Google Pay

{  
    "origin":"wallet",
    "status-code":"N804",
    "status-text":"Installed",
    "status-details":"Pass Installed on the App",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:02:16+00:00",
    "app-type":"Google Pay",
    "install-id":"d04d58f636b245d5"
    "reference-data": {
        "email": "fake.email@email.com",
        "phone": "10000000000",
        "transaction-id": "96"
                      }
}

5. Response: Pass Uninstalled from Apple Wallet

{  
    "origin":"wallet",
    "status-code":"N805",
    "status-text":"Uninstalled",
    "status-details":"Pass uninstalled from the App",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:32:57+00:00",
    "app-type":"Apple Wallet",
    "install-id":"d04d58f636b245d5"
    "reference-data": {
         "email": "fake.email@email.com",
         "phone": "10000000000",
         "transaction-id": "96"
                      }
}

6. Response: Pass Uninstalled from Google Pay

{  
    "origin":"wallet",
    "status-code":"N805",
    "status-text":"Uninstalled",
    "status-details":"Pass uninstalled from the App",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:35:38+00:00",
    "app-type":"Google Pay",
    "install-id":"d04d58f636b245d5"
    "reference-data": {
         "email": "fake.email@email.com",
         "phone": "10000000000",
         "transaction-id": "96"
                      }
}

7. Response: Pass Data Updated

{  
    "origin":"wallet",
    "status-code":"N806",
    "status-text":"Updated",
    "status-details":"Pass data updated on the server",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:08:23+00:00",
    "tracking-id":"xxxxxxxxxx"
}

8. Response: Pass Updated Notification for Apple Wallet

{  
    "origin":"wallet",
    "status-code":"N807",
    "status-text":"Notified",
    "status-details":"Pass update notified to the app",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:09:48+00:00",
    "tracking-id":"xxxxxxxxxx",
    "app-type":"Apple Wallet"
}

9. Response: Pass Updated Notification for Google Pay

{  
    "origin":"wallet",
    "status-code":"N807",
    "status-text":"Notified",
    "status-details":"Pass update notified to the app",
    "pass-template-id":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "pass-id":"EVENT-202036",
    "timestamp":"2018-12-20T10:08:23+00:00",
    "tracking-id":"xxxxxxxxxx",
    "app-type":"Google Pay"
}

Notification Parameters #

The response parameters table describes each field that appears in the Wallet Postback Notification.

Variable Description
status-code The status-code is used for the success, failure, updated, installed and uninstalled responses. A list of the Postback Notification Codes can be found in section 9.2.
origin The origin of where the response is coming from. In this case, the origin will always be “Wallet”.
status-text This gives an explanation of the status code. The status-text will have the following values depending on the type of response: Installed, Uninstalled, Updated, or Notified.
pass-id The custom ‘pass-id’ that is used when generating a pass or adding data to the pass in order to reference this pass in future requests.
timestamp The timestamp of when the pass was generated.
status-details This gives a more detailed explanation of the status-code and status-text.
pass-template-id The unique Pass Template ID used to reference a particular Pass Template.
tracking-id This is the tracking-id generated by our system for linking the postback with the API call.The tracking-id will be available only for passes generated or updated by the “generatepass”, “generatepassbyid”, “updatepassdata” APIs.
install-id The install-id represents the unique id for Apple Wallet and Google Pay.

Status Codes #

The post back notification codes table defines all of the codes that may appear in the Wallet Postback notification under ‘status-code’.

Code Description
N801 Pass was generated successfully.
N802 Some error occurred. Pass generation failed.
N804 Pass Installed on the device/app
N805 Pass Uninstalled on the app
N806 Pass data updated via API/Web
N807 Pass was updated on the app.

 

Go to Top