Cards

Card user, product, transactions and setup endpoints

Status check for create-card-user API

get

Responses

200

API status

application/json

get

/api/cards/create-card-user

HTTPcURLJavaScriptPython

GET /api/cards/create-card-user HTTP/1.1
Host: platform.madra.finance
Accept: */*

200

API status

{
  "message": "Create Card User API is running"
}

Create a new card user

post

Creates a Marqeta card user with first name, last name, and wallet address.

Body

application/json

firstNamestringRequiredExample: John

lastNamestringRequiredExample: Doe

walletAddressstringRequiredExample: 0xabc12345deadbeef6789

Responses

200

Card user created

application/json

400

Missing required fields

404

User not found

500

Internal server error

post

/api/cards/create-card-user

HTTPcURLJavaScriptPython

POST /api/cards/create-card-user HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "firstName": "John",
  "lastName": "Doe",
  "walletAddress": "0xabc12345deadbeef6789"
}

{
  "userResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Fetch and store card products

post

Body

application/json

cardUserIdstringRequiredExample: user_123456

Responses

200

Card products fetched and stored

application/json

500

Internal server error

post

/api/cards/create-card-product

HTTPcURLJavaScriptPython

POST /api/cards/create-card-product HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "cardUserId": "user_123456"
}

{
  "cardProductResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Status check for create-card API

get

Responses

200

API status

application/json

get

/api/cards/create-card

HTTPcURLJavaScriptPython

GET /api/cards/create-card HTTP/1.1
Host: platform.madra.finance
Accept: */*

200

API status

{
  "message": "Create Card API is running"
}

Create card using card product and user token

post

Body

application/json

cardProductTokenstringRequiredExample: cp_123456

userTokenstringRequiredExample: user_123456

walletAddressstringOptionalExample: 0xabc12345deadbeef6789

Responses

200

Card created

application/json

400

Missing required parameters

404

User not found

500

Internal server or Marqeta API error

post

/api/cards/create-card

HTTPcURLJavaScriptPython

POST /api/cards/create-card HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "cardProductToken": "cp_123456",
  "userToken": "user_123456",
  "walletAddress": "0xabc12345deadbeef6789"
}

{
  "cardCreateResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cardResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Status check for fund-card API

get

Responses

200

API status

application/json

get

/api/cards/fund-card

HTTPcURLJavaScriptPython

GET /api/cards/fund-card HTTP/1.1
Host: platform.madra.finance
Accept: */*

200

API status

{
  "message": "Fund Card API is running"
}

Fund card

post

Body

application/json

user_tokenstringRequiredExample: user_abc123

amountnumberRequiredExample: 100

currencyCodestringRequiredExample: USD

Responses

200

Card funded

application/json

400

Missing required fields

500

Internal server or Marqeta API failure

post

/api/cards/fund-card

HTTPcURLJavaScriptPython

POST /api/cards/fund-card HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 62

{
  "user_token": "user_abc123",
  "amount": 100,
  "currencyCode": "USD"
}

{
  "fundCardResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Status check for send-transaction API

get

Responses

200

API status

application/json

get

/api/cards/send-transaction

HTTPcURLJavaScriptPython

GET /api/cards/send-transaction HTTP/1.1
Host: platform.madra.finance
Accept: */*

200

API status

{
  "message": "Fund Card API is running"
}

Send card transaction

post

Body

application/json

amountnumberRequiredExample: 100

card_tokenstringRequiredExample: card_abcdef

card_acceptor_midstringRequiredExample: mid_123456

networkstringRequiredExample: visa

webhookstringOptionalExample: https://example.com/webhook

Responses

200

Transaction simulated

application/json

400

Missing required fields

500

Internal server or Marqeta API failure

post

/api/cards/send-transaction

HTTPcURLJavaScriptPython

POST /api/cards/send-transaction HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 131

{
  "amount": 100,
  "card_token": "card_abcdef",
  "card_acceptor_mid": "mid_123456",
  "network": "visa",
  "webhook": "https://example.com/webhook"
}

{
  "simulationResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}

Status check for card setup API

get

Responses

200

API status

application/json

get

/api/cards/setup

HTTPcURLJavaScriptPython

GET /api/cards/setup HTTP/1.1
Host: platform.madra.finance
Accept: */*

200

API status

{
  "message": "Create Card API is running"
}

Setup card user, products, and card in one workflow

post

Body

application/json

firstNamestringRequiredExample: Jane

lastNamestringRequiredExample: Doe

walletAddressstringRequiredExample: 0xabc12345deadbeef6789

Responses

200

Setup complete with user, products and card created

application/json

400

Missing required fields

404

User not found

500

Internal server error during setup

post

/api/cards/setup

HTTPcURLJavaScriptPython

POST /api/cards/setup HTTP/1.1
Host: platform.madra.finance
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "firstName": "Jane",
  "lastName": "Doe",
  "walletAddress": "0xabc12345deadbeef6789"
}

{
  "userResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cardProductResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "cardCreateResult": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "card": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
}