BLSALE

1. Rover Data
2. ›Rover
3. ›Business Suite
4. ›Pay
5. ›BLSALE

2 min read

The BLSALE endpoint authorizes the form of payment and captures the payment. See below for request/response examples.

POST Request Format

Attribute	Description	Required
atoken	Authorization token to access API	✔️
entity	Description of the resource / service	✔️
store	This is a unique assignment for your location(s) Merchant accounts are assigned by store/Location	✔️
reg	This identifies the POS station, user, terminal or process requesting a transaction	✔️
date	This is the date of the request made to Rover Pay
tran	This is the sequential number for the REG requesting the transaction
invoice	This is the sequential number that will allow INQUIRY based on this ID through blinquire
amount	Amount to be authorized with two implied decimals 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
level23	Optional Level 2 / Level 3 transaction data. See Level 2 / Level 3 Data for the schema and validation rules
debug	If flag is set then error messages will be more verbose

Example Request (basic)

{
    "atoken": {{atoken}},
    "entity": {{entity}},
    "store": {{store}},
    "reg": {{reg}},
    "date": "",
    "tran": "rc783",
    "invoice": "rc7822",
    "amount": "353",
    "manual": "0",
    "debug": {{debug}}
}

Example Request (with Level 2 / Level 3 data)

{
    "atoken": {{atoken}},
    "entity": {{entity}},
    "store": {{store}},
    "reg": {{reg}},
    "date": "",
    "tran": "rc783",
    "invoice": "rc7822",
    "amount": "1230",
    "manual": "0",
    "level23": {
        "ponumber": "PO-20050",
        "taxamnt": "80",
        "taxexempt": "N",
        "frtamnt": "150",
        "dutyamnt": "0",
        "orderdate": "20260427",
        "shiptozip": "92614",
        "shipfromzip": "85284",
        "shiptocountry": "US",
        "items": [
            {
                "lineno": "1",
                "material": "WIDGET-100",
                "description": "Blue widget",
                "upc": "012345678905",
                "quantity": "2",
                "uom": "EA",
                "unitcost": "500",
                "netamnt": "1000",
                "taxamnt": "80"
            },
            {
                "lineno": "2",
                "description": "Ground shipping",
                "quantity": "1",
                "uom": "EA",
                "unitcost": "150",
                "netamnt": "150",
                "taxamnt": "0"
            }
        ]
    },
    "debug": {{debug}}
}

Example Response

Attribute	Description
verified	Flag will be set to 1 if call was successful or 0 if it failed
errorCode	Error Code
errMessage	Error Message
resultId	If error occurred will be empty, otherwise will hold the reqID that can be used for the BLTOKENREFUND endpoint
ccvRec	Base 64 Encoded String which holds the Token
token	Token that is represented as a 16 character string
expiry	Expiration date for card used formatted as MMYY
signature	Base 64 encode GZIPPED BMP FILE
level23Errors	Comma-delimited list of Level 2 / Level 3 validation issues, omitted when none. See Level 2 / Level 3 Data

{
    "verified": "1",
    "errorCode": "",
    "errorMessage": "",
    "resultId": "1*19562*110*rc783*7",
    "ccvRec": "NCoqKioqKioqMDA3Nv4xMjIy/v5QUFM0MTP+MjAzMzEzMDQ3Njgx/v5FTkNSWVBURUT+Vv5WaXNh/v5Q/v5bRDIwXSBDaGFyZ2UgQWNjZXB0ZWQu/v7+/v7+MSoxOTU2MioxMTAqcmM3ODMqN/4yMDT+/v7+/v7+/v7+/jM1M/7+/v7+/v7+Q0MtU0FMRf45NDc4ODQ4NzE4NjUwMDc2/kJPTFT+/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v4g/lj+cmM3ODI3/kg0c0lDQUFBQUFBQy8xTkpSeTVDVFZBQTdOR2hEY0pRQUVYUis3Zm9DQTJxc3FxaW5sV1lqb0hZNUdNUWVFUkRjbzU5dWVxZDk4ZXRxbzVxclY2am50Vm9WTFY5OW05enpnQUFBQUFBZ0wreVhkVHVQN1NMMndBQUFBQ3U5eDRBYVgxZ1cyNHFBQUE9",
    "token": "9478848718650076",
    "expiry": "1222",
    "signature": "H4sICAAAAAAC/1NJRy5CTVAA7NGhDcJQAEXR+7foCA2qsqqinlWYjoHY5GMQeERDco59ueqd98etqo5qrV6jntVoVLV99m9zzgAAAAAAgL+yXdTuP7SL2wAAAACu9x4AaX1gW24qAAA="
}

---