View Debit Card Transaction

Get details on purchases made with the debit card

This call is used to view transactions on issued debit cards. You will need to pass the user_id, node_id and trans_id in the path of this call.

API ENDPOINT

https://uat-api.synapsefi.com/v3.1/users/:user_id/nodes/:node_id/trans/:trans_id

PATH PARAMETER

user_id :
required
string

ID of user

node_id :
required
string

ID of node

trans_id :
required
string

ID of transaction

EXAMPLE REQUEST

GET /v3.1/users/56f99b9386c2730f8d3de4d3/nodes/5c5e11c0f41098006870e848/trans/5c5e1807f41098006870ee0d HTTP/1.1
Host: uat-api.synapsefi.com
X-SP-USER-IP: 127.0.0.1
X-SP-USER: oauth_BcV9rmzTRKvDix8Ge32uN1qdkhfblgo7CtXQnJsZ|n38dj3h8NE393bv24ovoRY34kd62
Content-Type: application/json
node_id = '594e606212e17a002f2e3251'
trans_id = '594e72124599e8002fe62e4f'

user.get_trans(node_id, trans_id)
const nodeID = '594e606212e17a002f2e3251';
const trxnID = '594e72124599e8002fe62e4f';

user.getTransaction(nodeID, trxnID);
node_id = '594e606212e17a002f2e3251'
trans_id = '594e72124599e8002fe62e4f'

transaction = user.get_node_transaction(node_id: node_id, trans_id: trans_id)
$nodeid = 'your_node_id';
$transid = 'your_trans_id';

$usertrans = $user->get_trans( $nodeid, $transid );
nodeID := "594e606212e17a002f2e3251"
transID := "594e72124599e8002fe62e4f"

data, err := user.GetTransaction(nodeID, transID)

EXAMPLE RESPONSE

{
  "_id": {
    "$oid": "5c5e1807f41098006870ee0d"
  },
  "_v": 2,
  "amount": {
    "amount": 4.99,
    "currency": "USD"
  },
  "client": {
    "id": "5c5dbf87d051f0742484fd3f",
    "name": "SynapseFI"
  },
  "extra": {
    "asset": null,
    "created_on": {
      "$date": 1549579319000
    },
    "encrypted_note": "",
    "group_id": null,
    "ip": "435.521.0.1",
    "latlon": "0,0",
    "note": "PANDORA*INTERNET RADIO",
    "other": {
      "approved": false,
      "async_ran": true,
      "attachments": [],
      "create_email_sent": false,
      "dispute_form": null,
      "disputed": false,
      "do_next": false,
      "process": {
        "credit": 0,
        "debit": 0
      },
      "provisional_credit_transaction_id": null,
      "settlement_batch_id": null,
      "show_queue": false,
      "skip_validation": true
    },
    "process_on": {
      "$date": 1549600937245
    },
    "same_day": false,
    "settlement_delay": 0,
    "supp_id": "5c5e14f1f41098006870ebad"
  },
  "fees": [
    {
      "fee": 0,
      "note": "Synapse Facilitator Fee",
      "to": {
        "id": {
          "$oid": "5c5e14f1f41098006870ebad"
        }
      }
    }
  ],
  "from": {
    "id": {
      "$oid": "5c5e11c0f41098006870e848"
    },
    "nickname": "John Smith Checking",
    "type": "DEPOSIT-US",
    "user": {
      "_id": {
        "$oid": "56f99b9386c2730f8d3de4d3"
      },
      "legal_names": [
        "John Smith"
      ]
    }
  },
  "recent_status": {
    "date": {
      "$date": 1549600952255
    },
    "note": " -- ",
    "status": "SETTLED",
    "status_id": "4"
  },
  "timeline": [
    {
      "date": {
        "$date": 1549600952255
      },
      "note": " -- ",
      "status": "SETTLED",
      "status_id": "4"
    },
    {
      "date": {
        "$date": 1549600949605
      },
      "note": "Next",
      "status": "PROCESSING-CREDIT",
      "status_id": "3"
    },
    {
      "date": {
        "$date": 1549600943358
      },
      "note": "Next",
      "status": "PROCESSING-DEBIT",
      "status_id": "2"
    },
    {
      "date": {
        "$date": 1549600937245
      },
      "note": "Transaction Created.",
      "status": "CREATED",
      "status_id": "1"
    }
  ],
  "to": {
    "id": {
      "$oid": null
    },
    "meta": {
      "address": "PANDORA*INTERNET RADIO PDORA.COM/BILCA 94612",
      "foreign_transaction": false,
      "interchange_object": {
        "amount": "0.12",
        "rate": {
          "cap": 2,
          "flat_fee": "0.15",
          "percent": "0.65"
        }
      },
      "merchant_category": "service",
      "merchant_logo": "https://cdn4.synapsefi.com/uploads/2018/12/06/RA74nDG00oNEuj8kdeJCT2bOXU6z5Bqfx3HvFQLZl9hSgsyimt.png",
      "merchant_name": "Pandora*internet Radio",
      "merchant_official_page": null,
      "merchant_phone_number": null,
      "merchant_subcategory": "discretionary_spending",
      "primary_category": "5968",
      "secondary_category": "NOT_RECURRING",
      "surcharge": "0.00",
      "type": "POS_DEBIT"
    },
    "nickname": null,
    "type": "EXTERNAL-US",
    "user": {
      "_id": {
        "$oid": null
      },
      "legal_names": [
        "PANDORA*INTERNET RADIO"
      ]
    }
  }
}

Merchant Category and Subcategory

Merchant Category and Subcategory are ways to help define types of transactions that users do on their issued debit cards.

Keep in mind: this is in beta and these categories might change as we refine these more.

MERCHANT CATEGORY (DEBIT)

Category
Category Description

bank_fee

Fees charged by the bank

bill/loan

Money debited from the account with ACH cashed checks

digital_payment

Payments to merchants made with a digital payment system

pos

Generic Point of Sale transactions (debit card swipes, online payments with debit card number)

subscription_service

Automatic recurring transactions

transfer

Money transfers to user's accounts in the bank/other financial institutions, P2P transfers, wires

withdrawal

Cash withdrawals, deposit adjustments, reversed transactions

grocery

Grocery stores

dining

Restaurants, bars, coffeeshops

medical

Pharmacies, Medical institutions

retail

Purchase of any goods

service

Service industry

travel/transportation

Gas stations, Airlines, Hotels

MERCHANT CATEGORY (CREDIT)

Category
Category Description

bank_refund

Money credited by the bank (fee reimbursement, claim credits, reversed transactions etc.)

deposit

Credits that refer to user's income (cash/check deposits, payroll, direct deposits)

interest/rewards

Interest or bank rewards (cash back and bonuses)

refund

Merchant credits to user's debit card (purchase returns etc.)

transfer

Money transfers from user's accounts in the bank/other financial institutions, P2P transfers, wires

MERCHANT SUBCATEGORY

Transactions are sub-categorized by if they are a recurring transaction or not.

Subcategory
Subcategory Description

discretionary_spending

non-recurring transaction

non_discretionary_spending

recurring transaction

View Debit Card Transaction


Get details on purchases made with the debit card

Suggested Edits are limited on API Reference Pages

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