Skip to content

BLTOKENREFUND

This endpoint is used to refund an amount that was previously authorized through BLAUTH or BLTOKENAUTH

POST Attribute Format

AttributeDescriptionRequired
atokenAuthorization token to allow access to the service✔️
entityThis tells the api what database to use for your transactions✔️
storeThe unique assignment for you location(s) Merchant accounts are assigned by store/location✔️
regthis identifies the POS station, user, terminal or process requesting transaction✔️
dateDate of the request made to Rover Pay
tranThis is the sequential number for the REG requesting the transaction
invoiceInvoice must be unique per card request in order to request Inquiry from blinquire
ctokenThis is the token received from BLTOKENIZE✔️
expiryCredit card expiration date✔️
amountAmount to be refunded from the previous authorized amount✔️
reqidThis is the resultID from the transaction✔️
debugIf flag is set then error messages will be more verbose

Example Request

Javascript
{
    "atoken": {{atoken}},
    "entity": {{entity}},
    "store": {{store}},
    "reg": {{reg}},
    "date": "",
    "tran": "rc783",
    "invoice": "rc7826",
    "ctoken": "9478848718650076",
    "expiry": "1222",
    "amount": "-200",
    "reqid": "1*19562*110*41642*1",
    "debug": {{debug}}
}

Example Response

AttributeDescription
verified1 if success 0 if failure
errorCodeError Code
errMessageError Message
resultIdIf error occurred will be empty, otherwise will hold the reqID
ccvRecBase 64 Encoded String which holds the Token
Javascript
{
    "verified": "1",
    "errorCode": "",
    "errorMessage": "",
    "resultId": "",
    "ccvRec": "OTQ3ODg0ODcxODY1MDA3Nv4xMjIy/v7+/v5FTkNSWVBURUT+/v5CTP5Q/v5bRDEwXSBBIGNoYXJnZSBmb3IgdGhpcyB0cmFuc2FjdGlvbiwgYW5kIGFtb3VudCBhbHJlYWR5IGV4aXN0cyEH/TwxPj1DaGFyZ2UgdGhpcyBjYXJkIGFnYWluLCA8Mj49VXNlIGV4aXN0aW5nIGF1dGhvcml6YXRpb24sIDwzPj1FeGl0/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v5UT0tFTi1SRVRVUk7+/kJPTFT+/v7+/v4xKjE5NTYyKjExMCo0MTY0Miox/v7+/v7+/v7+/v7+/v7+/v7+/v7+/v5yYzc4MjY="
}