Transaction Response Codes

This page provides details on transaction response codes, including approval codes, decline codes, gateway declines, and AVS response codes.

TIP

Response Codes are grouped as follows: 100 thru 199 are Approvals and Partial Approvals. 200 thru 299 are Declined via the processor. 300 thru 399 are Gateway Declines. 400 thru 499 are processor rejection errors.

Response Code	Processor Definition	Description
0	Unknown	Unknown, please contact support for more information
99	Pending payment	Used in redirect processors prior to payment being received
100	Approved	Transaction was successfully approved
110	Partial approval	Transaction was successfully approved, but for a lesser amount
200 - 299	Decline	Transaction has been declined by the issuer for various reasons
300 - 399	Gateway Decline	Platform decline for configuration or fraud reasons
400 - 499	Transaction error returned by processor	Errors returned from the processor

AVS Response Codes

Address verification response codes (AVS)

AVS Response Code	Definition	Code Applies to	Card Brands
0	AVS Not Available	Domestic + International	V, MC, AX, D, PP, JCB
A	Address match only	Domestic + International	V, AX, D,PP, JCB
B	Address matches, ZIP not verified	Domestic + International	V
C	Incompatible format	Domestic + International	V
D	Exact match	International	V
F	Exact match, UK-issued cards	Domestic + International	V
G	Non-U.S. Issuer does not participate	International	V
I	Not verified	International	V, D, PP, JCB
M	Exact match	International	V
N	No address or ZIP match	Domestic + International	V, MC, AX, D, PP, JCB
P	Postal Code match	Domestic + International	V
R	Issuer system unavailable	Domestic	V, MC, AX, D, PP, JCB
S	Service not supported	Domestic	MC, AX, D, PP, JCB
U	Address unavailable	Domestic	V, MC, AX, D, PP, JCB
W	9-character numeric ZIP match only	Domestic + International (MC)	MC, D, PP, JCB
X	Exact match, 9-character numeric ZIP	Domestic + International (MC)	MC, D, PP, JCB
Y	Exact match, 5-character numeric ZIP	Domestic	V, MC, AX, D, PP, JCB
Z	5-character ZIP match only	Domestic + International (V)	V, MC, AX, D, PP, JCB
L	Partial match, Name and billing postal code match	For AMEX cards only	AX
1	Cardholder name and ZIP match	Domestic	AX
2	Cardholder name, address and ZIP match	Domestic	AX
3	Cardholder name and address match	Domestic	AX
4	Cardholder name matches	Domestic	AX
5	Cardholder name incorrect, ZIP matches	Domestic	AX
6	Cardholder name incorrect, address and zip match	Domestic	AX
7	Cardholder name incorrect, address matches	Domestic	AX
8	Cardholder name, address, and ZIP do not match	Domestic	AX

Sample Response Bodies

Example transaction response bodies for different payment methods.

{
  "status": "success",
  "msg": "success",
  "data": {
    "id": "b7kgflt1tlv51er0fts0",
    "type": "sale",
    "amount": 1112,
    "tax_amount": 100,
    "tax_exempt": false,
    "shipping_amount": 100,
    "discount_amount": 0,
    "payment_adjustment_type": "",
    "payment_adjustment_value": 0,
    "currency": "usd",
    "description": "test transaction",
    "order_id": "someOrderID",
    "po_number": "somePONumber",
    "ip_address": "4.2.2.2",
    "email_receipt": false,
    "email_address": "user@home.com",
    "payment_method": "card",
    "response_body": {
      "card": {
        "id": "b7kgflt1tlv51er0ftsg",
        "card_type": "visa",
        "first_six": "401200",
        "last_four": "5439",
        "masked_card": "401200******5439",
        "expiration_date": "12/20",
        "response": "approved",
        "response_code": 100,
        "auth_code": "TAS731",
        "processor_response_code": "00",
        "processor_response_text": "APPROVAL TAS731 ",
        "processor_type": "tsys_sierra",
        "processor_id": "b7kgflt1tlv51er0f1sg",
        "bin_type": "STANDARD",
        "type": "debit",
        "avs_response_code": "0",
        "cvv_response_code": "M",
        "processor_specific": {},
        "created_at": "2017-10-19T20:15:19.80368Z",
        "updated_at": "2017-10-19T20:15:20.777011Z"
      }
    },
    "status": "pending_settlement",
    "response": "approved",
    "response_code": 100,
    "customer_id": "aaaaaaaaaaaaaaaaaaaa",
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "company": "Test Company",
      "address_line_1": "123 Some St",
      "address_line_2": "",
      "city": "Wheaton",
      "state": "IL",
      "postal_code": "60187",
      "country": "US",
      "phone": "5555555555",
      "fax": "5555555555",
      "email": "help@website.com"
    },
    "shipping_address": {
      "first_name": "John",
      "last_name": "Smith",
      "company": "Test Company",
      "address_line_1": "123 Some St",
      "address_line_2": "",
      "city": "Wheaton",
      "state": "IL",
      "postal_code": "60187",
      "country": "US",
      "phone": "5555555555",
      "fax": "5555555555",
      "email": "help@website.com"
    },
    "created_at": "2017-10-19T20:15:19.560708Z",
    "updated_at": "2017-10-19T20:15:20.832049Z"
  }
}