Home » Rover ERP Overview » Rover Hub Overview » Rover Pay Overview » BLTOKENAUTH

BLTOKENAUTH

Read Time: 2 minute(s)

This endpoint authorizes a tokenized form of payment for a specified amount.

POST Request Attributes

Attribute	Description	Required
atoken	Authorization token to allow access to the service	✔️
entity	This tells the api what databse to use for your transactions	✔️
store	The unique assignment for you location(s) Merchant accounts are assigned by store/loction	✔️
reg	this identifies the POS station, user, termial or process requesting transaction	✔️
date	Date of the request made to Rover Pay
tran	This is the sequential number for the REG requesting the transaction
invoice	Invoice must be unique per card request in order to request Inquiry from blinquire
ctoken	This is the token recieved from BLTOKENIZE	✔️
amount	Amount to be authorized with two implied decimal places (example: to specify "$10.00," use "1000")	✔️
manual	If flag is set to 0 then it requests an MSR (magnetic stripe), EMV (chip), or NFC (contactless) payment card interaction, else it will request manually-entered data
debug	If flag is set then error messages will be more verbose

Example Request

{
    "atoken": {{atoken}},
    "entity": {{entity}},
    "store": {{store}},
    "reg": {{reg}},
    "date": "",
    "tran": "",
    "invoice": "",
    "ctoken": "",
    "expiry": "",
    "amount": "",
    "debug": {{debug}}
}

Example Response

Attribute	Description
verified	Flag will be set to 1 if call was succesfull or 0 if it failed
errorCode	Error Code
errMessage	Error Message
resultId	Result ID that can be used as the reqID field
ccvRec	Base 64 Encoded String which holds the Token

{
    "verified": "1",
    "errorCode": "",
    "errorMessage": "",
    "resultId": "1*19562*110*41642*1",
    "ccvRec": "NCoqKioqKioqMDA3Nv4xMjIy/v5QUFM4ODn+MjAzNzg0MDQ4ODQz/v5FTkNSWVBURUT+Vv5WaXNh/v5Q/v5bRDIwXSBDaGFyZ2UgQWNjZXB0ZWQu/v7+/v7+MSoxOTU2MioxMTAqNDE2NDIqMf7+/v7+/v7+/v7+/jEwMDD+/v7+/v7+/lRPS0VOLUFWU/45NDc4ODQ4NzE4NjUwMDc2/kJPTFT+/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v4g/lj+/kg0c0lDQUFBQUFBQy8xTkpSeTVDVFZBQTdNc3hFY0pBQUFEQmV4ZEl5S1NLQWdyNmVFQUI2aUlJSjA5RFFVK1JHZGh0Yis2MlA5YXF1bFpMOVJ4MVZLTlIxZmJ1bithY0FRQUFBQURudXB6MGJsKzg5ejk3QVFBQUFBQit3V3NBQ09Jb1ZHNHFBQUE9"
}

---