Receipt Data

Alan Gillespie · August 2017

I'm wondering if there is an endpoint within the Luminate Online APIs to retrieve the data set that gets passed to generate the PDF tax receipts? The hope is to build a self-service tool for our constituents to go online and retrieve a misplaced tax receipt and save customer care call times.

Daniel Hartanto · August 2017

To build the Receipt Viewer URL, you get the tx_id parameter value from the returned confirmation_code of the getUserTransactions API
http://open.convio.com/api/?referrer=https://www.google.com/#constituent_api.getUserTransactions_method.html

So the snippet that you could reuse/integrate should look similar to this (note: change the domain name with your domain name)

var confirmationCode = this.confirmation_code;
var position = confirmationCode.lastIndexOf('-');
var tx_id = confirmationCode.substring(position+1);
var receiptViewerURL = 'http://YOURDOMAINNAME/site/ReceiptViewer?tx_id=' + tx_id;

regards,

Daniel

Alan Gillespie · September 2017

Just as a follow up to this... The above code strictly parses out the transaction id and it assumes the user has been authenticated by Luminte Online. In the case of what I am developing, I need to augment the above URL structure to authenticate the users on Luminate Online side with a URL that looks like this:

https://<LUMINATE SECURE SITE>/site/ReceiptViewer;jsessionid=<JSESSION ID>?tx_id=<TRANSACTION ID>&NONCE_TOKEN=<NONCE TOKEN>

<JSESSION ID> & <NONCE TOKEN> can be obtained from payloads within the Single Sign On API (http://open.convio.com/api/#single_sign_on_api.SingleSignonAPI.html) using either of the following method, depending on how you're authenicating your users:

login (http://open.convio.com/api/#single_sign_on_api.login_method.html)
or getSignleSignOnToken (http://open.convio.com/api/#single_sign_on_api.getSingleSignOnToken_method.html)

I figure this could save some devs a bunch of time in digging around if they're building similar 3rd party applications.

Receipt Data

Comments

Categories