Bit Capital

The Bit Capital Developer Hub

Welcome to the Bit Capital developer hub. You'll find comprehensive guides and documentation to help you start working with the platform as quickly as possible, as well as support if you get stuck. Let's jump right in!

Guides    Community

Handling Transactions exceptions

Diagnose and fix transaction errors

Overview

All transactions in the platform are executed asynchronously, that is, once you request a new Transaction it is registered as pending and sent to the execution pipeline. Whenever the transaction state changes a new Postback is sent and the transaction.status field gets updated.

You may check the state.additionalData field from the last transaction.states[] entry to get specific details about the transaction failure.


Cards Transactions

All cards transactions are internationally standardized using ISO 8583. Whenever a Card transaction is processed, a Result Code is emitted both on the POS machine and the Web Gateways. This code is used to identify possible scenarios where the physical or virtual cards may not be working.


VISA Response Codes

Code

Description

00

Transaction completed

01

Card problem

03

Establishment not registered

05

Transaction refused

06

Try again

07

Special Condition ( cancelled / stolen card)

10

Invalid unblock code

12

Transaction no permitted to this establishment

13

Invalid value

14

Invalid card

30

Format error

31

Establishment not in environment

41

Reverse Validity Date / Embedded data differ from the registration

43

Stolen card

51

Insufficient funds

52

Invalid coupon

54

Card out-of-date (invalid)

55

Invalid or unregistered password

56

Card does not exist

57

Transaction cancelled (or already cancelled)

58

Invalid terminal

59

Account has pending debits (cardholder)

61

Overlimit exceeded

62

Invalid session key

65

Overlimit permitted quantity exceeeded

76

Blocked card

80

Total exceeded

81

Duplicated payment

83

Due date

84

Invalid dealer / merchant

85

Query not authorized

94

Transaction already registered

96

System error

99

Original transaction not found / Parameter error

đŸ“˜

Tip

Attempts of card transactions may get flagged as a suspicious activity or attempted fraud. In this case, you may get errors other than the 55 even with the correct PIN Code. Contact the consumer to ensure that the card has not been stolen and open a ticket with the Help Desk.

For more information, refer to the official Visa Request and Response Codes developer guidelines.

Updated 5 months ago


Handling Transactions exceptions


Diagnose and fix transaction errors

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.