DocumentationAPI Reference
Documentation

About

The Reach Stash allows the temporary storage of client data for use in subsequent Checkout API requests.

Stash is typically used to store cardholder data sent from the customer's browser, allowing other Checkout API requests to originate from the merchant's servers without having cardholder data pass through those servers.

Overview

StashId

The merchant can specify the StashId in the /stash call by appending the StashId to the URL:

https://stash.rch.how/{MerchantId}/{StashId}

i.e. https://stash.rch.how/2a144a21-066a-42fe-a553-736a777e39e2/RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp
https://stash.gointerpay.net/{MerchantId}/{StashId}

The StashId can be the same platform's cart id, order id, session id or any other identifier that they wish for simplicity. Whatever the StashId is set to, that same StashId will need to be sent in with the /checkout request.

Sample Stash Request

Valid Request with No Warnings

$ curl -d "DeviceFingerprint=4e0298ed-e139-4325-b5b5-258abe470eba&card=%7B%22Name%22%3A%22Clark%20Kent2%22%2C%22Number%22%3A%224242424242424242%22%2C%22VerificationCode%22%3A%22281%22%2C%22Expiry%22%3A%7B%22Year%22%3A%222030%22%2C%22Month%22%3A%2203%22%7D%7D" https://stash.rch.how/2a144a21-066a-42fe-a553-736a777e39e2/RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp
 
{"StashId":"RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp","Last4":"4242","Warnings":[]}

Valid Request with Invalid Card Number

$ curl -d "DeviceFingerprint=4e0298ed-e139-4325-b5b5-258abe470eba&card=%7B%22Name%22%3A%22Clark%20Kent2%22%2C%22Number%22%3A%224242424242424243%22%2C%22VerificationCode%22%3A%22281%22%2C%22Expiry%22%3A%7B%22Year%22%3A%222030%22%2C%22Month%22%3A%2203%22%7D%7D" https://stash.rch.how/2a144a21-066a-42fe-a553-736a777e39e2/RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp
 
{"StashId":"RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp","Last4":"4243","Warnings":["CardNumberInvalid"]}

Valid Request with Invalid Card Number, Invalid Expiry Month, and Invalid Validation Code / CVV

$ curl -d "DeviceFingerprint=4e0298ed-e139-4325-b5b5-258abe470eba&card=%7B%22Name%22%3A%22Clark%20Kent2%22%2C%22Number%22%3A%224242424242424243%22%2C%22VerificationCode%22%3A%22281x%22%2C%22Expiry%22%3A%7B%22Year%22%3A%222020%22%2C%22Month%22%3A%2214%22%7D%7D" https://stash.rch.how/2a144a21-066a-42fe-a553-736a777e39e2/RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp
 
{"StashId":"RccAl5JE6D3a1RLJdrJ5XbbJJNfXSldV2K2CXPCSBtRnuC0bRLNO65Lp","Last4":"4243","Warnings":["CardMonthInvalid","CardNumberInvalid","CardVerificationCodeInvalid"]}