Declined Transaction

Request Body for decline transaction (card transaction)

JSON

{
  "data": {
    "code": "{error_code}",
    "card_id": "0d91a7db-c800-02c1-2210-4ae200c06871",
    "description": "{error description}",
    "merchant": "Facebook Ads",
    "amount": 10.98,
    "currency": "USD",
  },
  "event_id": "0db7065a-c600-3af4-5b70-cea00aa226f3",
  "timestamp": "2024-04-30 21:30:02",
  "event_type": "TRANSACTION",
  "is_sandbox": false,
  "event_detail": "DECLINED_TRANSACTION"
}

Field	Type	Description
event_id	String UUID	Event's unique identifier
event_type	String	Event type for decline transaction is always TRANSACTION
event_detail	String	Event detail for decline transaction is always DECLINED_TRANSACTION
timestamp	Datetime	Date time for event using format YYYY-mm-DD HH:MM:SS
data	Object	Contain detail of event
code	String	Error code, see table below.
description	String	Error description, see table below
card_id	String UUID	Card unique identifier
merchant	String	Merchant description
amount	Float	Failed amount (merchant currency)
currency	String	Merchant currency code (ISO 4217)

Error Code	Description	Handling suggestion
REFER_TO_CARD_ISSUER	Refer to card issuer	Contact Monit customer service
INVALID_MERCHANT	Invalid merchant	Check merchant lock settings on Monit dashboard.
DO_NOT_HONOR	Do not honor	Contact Monit customer service
PARTIAL_APPROVE	Partial approval	Contact Monit customer service
INVALID_TRANSACTION	Invalid transaction	Contact Monit customer service
INVALID_AMOUNT	Invalid amount	Check card spending type, make sure that card is unlocked.
INVALID_CARD_NUMBER	Invalid card number	Check card details.
INVALID_ISSUER	Invalid issuer	Contact Monit customer service
FORMAT_ERROR	Format Error	Contact Monit customer service
INSUFFICIENT_FUNDS	Insufficient funds	Check card balance and limit settings and make sure that card is unfrozen.
EXPIRED_CARD	Expired card	Contact Monit customer service to extend card expiry date
INVALID_PIN	Invalid PIN	Check card details.
TRANSACTION_NOT_PERMITTED	Transaction not permitted to cardholder	Contact Monit customer service
EXCEEDS_LIMIT	Exceeds withdrawal limit	Contact Monit customer service
RESTRICTED_CARD	Restricted card	Contact Monit customer service
SECURITY_VIOLATION	Security violation	Contact Monit customer service
PIN_NOT_CHANGED	PIN not changed	Currently our card does not support for PIN transactions
PIN_TRIES_EXCEEDED	Allowable number of PIN tries exceeded	Currently our card does not support for PIN transactions
ACCOUNT_NOT_FOUND	Invalid/nonexistent “To Account” specified or Invalid/nonexistent “From Account” specified or Invalid/nonexistent “Account Type” specified	Check merchant validity.
DOMESTIC_NOT_ALLOWED	Domestic transactions not allowed	Check merchant location.
INVALID_AUTH	Invalid Authorization Life Cycle	Currently our card does not support for PIN transactions
NOT_DECLINED	Not declined (Valid for all zero amount transactions)	Contact Monit customer service
PIN_VALIDATION_NOT_POSSIBLE	PIN validation not possible	Currently our card does not support for PIN transactions
PURCHASE_AMOUNT_ONLY	Purchase amount only	Contact Monit customer service
CRYPTOGRAPHIC_FAILURE	Cryptographic failure	Contact Monit customer service
CANNOT_VERIFY_PIN	Unacceptable PIN—Transaction Declined—Retry	Currently our card does not support for PIN transactions
ISSUER_DOWN	Issuer or switch inoperative	Contact Monit customer service
UNABLE_TO_ROUTE	Unable to route	Contact Monit customer service
DUPLICATE_TRANSACTION	Duplicate Transmission	Contact Monit customer service
SYSTEM_ERROR	System malfunction	Contact Monit customer service
UNKNOWN_ERROR	Unknown System Error	Contact Monit customer service