Marqeta Integration 101: First Steps and Basic API Structure

The number of companies using Marqeta to issue credit cards and process payments continues to grow quickly. If you’re considering doing the same, it’s important to understand how integrating the platform and its structure with your business works.

Marqeta Integration 101: First Steps and Basic API Structure

The number of companies using Marqeta to issue credit cards and process payments continues to grow quickly. If you’re considering doing the same, it’s important to understand how integrating the platform and its structure with your business works.

Plenty of beginner-friendly documentation exists that outlines the integration process, of course. Marqeta does a great job of making materials that are accessible even to finance and fintech novices. However, I wanted to put together a brief 101 article that offers a simple primer on the process.

In this article, you’ll get a bird’s eye view of Marqeta’s cornerstone models and concepts. I hope this eases the work of digging through official documentation and gives you a basic understanding of the Marqeta integration to support you before you even open their quick guide.

What is Marqeta?

To begin, let’s get an overview of the Marqeta platform.

Companies use Marqeta to launch and manage their payment card programs. The platform works on their behalf with card networks and issuing banks to

  • issue cards
  • authorize transactions
  • communicate with settlement entities

Marqeta takes on all the hard work of card program management and lets you focus on controlling and managing processes via the API, SDK, and Dashboard.

When businesses want to avoid the high investment of building their own card issuing and management software, Kunai has often partnered with Marqeta to help clients integrate, launch, and support this fintech solution.

What can companies kicking things off with Marqeta expect?

Should you decide to leverage Marqeta to power your card program, you’ll move through a few well-defined steps.

1. Define your program.

The journey begins with defining your company’s card program. This is where you lay out the features and constraints of your card program. This includes the type of funding sources, whether you’ll issue physical and/or virtual cards, KYC details, and more.

Marqeta’s managers help you navigate this process, which is largely driven by human communication. This stage relies heavily on you, the client company, and your tech department. All three groups should work together to  capture important context, including the following:

  • the type of API used
  • how authorization tokens are issued, and
  • synchronous vs. asynchronous processes

These details and others will help the tech team plan, estimate the results of, and implement the solution.

2. Explore the sandbox.

After the features and constraints are hashed out, Marqeta creates a virtual sandbox. The sandbox is a dedicated cloud environment designated specifically to execute payment orchestration operations only for your company.

If you’re interested in learning the platform without this custom environment, perhaps you’re doing research on various financial APIs or negotiations between parties are taking longer, and you want to start development to be on time, then you can create your own dev sandbox on their website.

Some of your required parameters and entities will already be in the sandbox waiting for you. You can also access API endpoints and API keys to use in your HTTP requests from the sandbox’s home page:

The screenshot above is the simplest version of the Marqeta Dashboard: the web frontend through which you control your sandbox. This lets you control users, cards, payment options, API access, and much more.

It’s entirely up to you if you want to use the standard dashboard to manage your card program or want to build your own frontend using the custom flow. You might want to do that if you want to embed the dashboard features into your existing ERP portal or you want to give some of the control to end users. All the functionality is available through the API, so either approach works just as well as the other.

3. Create entities.

When you have access to a sandbox, you’ll need to create a User and Card in order to be able to perform transaction authorization. You’ll find a sample of commands that let you do exactly that in the Quick Guide.

At this point, you now have a sandbox and can access it via the Core API or Marqeta’s Dashboard. Within that sandbox, you have created a User and a Card. Now we’re ready to talk about where the money comes and goes within this structure.

The pipes that support money flow

The User and the Card are only the tip of the iceberg. They aren’t floating somewhere independently, but rather fit into a bigger and very important picture. Let’s dig into some details.

Understanding Account Holders

The User is a special kind of Account Holder. An Account Holder can either represent a real-world customer of Marqeta’s, such as your business, or it can represent your employees or clients. The exact representation depends on the type of business you’re running.

There are two types of Account Holders:

  • User: an individual account holder, represented by the user object
  • Business: a company account holder, represented by the business object

When you create Users, Businesses, and Cards or perform other actions in the sandbox, your application calls the Core API to create and manage users and businesses. You are communicating with the Core API via endpoints and tokens you find in the Dashboard.

Defining Relationships and How GPA Works

With the sandbox tools, you can do things like create parent-child relationships. This enables the child User to inherit some attributes and behaviors of the parent Business.

Each User and Business on the platform has a general-purpose account (GPA). The GPA holds funds used to make payments. The GPA is tied directly to the user or business — in other words, there is no separate GPA resource.

Managing Money Supply

This brings us to the supply side of the Marqeta platform. Pipeline money is dispensed from GPA. There are a couple of ways to fund a GPA, and these depend on the funding model you selected for your particular card program.

Without getting into too much detail, let’s look at two primary approaches:

  • Standard Funding: card accounts that carry a balance of funds for making payments. Funds are loaded into individual GPAs before cardholders can spend.

  • Just-in-Time (JIT) Funding: card accounts that carry no balance. Funds are held in your program funding account until a cardholder initiates a purchase.

You can manage funding sources using API calls such as /fundingsources/ach, /fundingsources/card, /fundingsources/program, and others found in the Core API docs.

Spending with Marqeta

Now let’s talk about the spending end of the pipeline, which is done via cards.

A User can own one or more cards. These are used as payment devices to spend funds from an account. Businesses cannot own cards; however, you can configure a child User to spend funds from a parent Business account.

You can also create both physical and virtual cards. Marqeta orders physical cards from a third-party provider and delivers them to specified addresses. Virtual cards are ready to use immediately.

Card Objects vs. Card Products

The card object in Marqeta stores details about the card like card number and security code. It’s a digital representation of an individual card. Each card has an associated User object, representing the card user, and a Card Product object, representing the card program with which it is associated.

The Card Product object defines attributes and behaviors for all associated cards. It operates as a template when creating new cards, but it’s important to note that the association with the Card Product object continues: updating the Card Product affects each associated card throughout the card’s lifetime.

Your program needs at least one Card Product before you can create a new card. That’s one of the entities you’re working to get right with sandbox.

This diagram summarizes the minimum structure you need to understand when dealing with Core API in Marqeta. If you can grasp this, you’re ready to fully appreciate the official documentation.

Moving beyond the basics...

There are several other important things you can do with Marqeta in order to fully leverage its potential. In fact, every or almost every integration Kunai performed for its clients required the following features to also be enabled:

  • KYC - or Know Your Customer. This is the procedure for verifying that individuals (or businesses) are those who (or what) they claim to be. Marqeta provides a couple approaches to KYC depending on your business situation
  • Spend Controls - This is the portion of the API that allows you to set up constraints regarding individuals’ spending. This also plays a role in JIT funding.
  • Just-in-Time Funding - JIT funding is how the system makes decisions about approving or declining transactions. It also determines the way you tailor this process to your business case.
  • Digital Wallets - As the world moves away from plastic, mobile-enabled spending is an increasingly common request from customers.
  • Webhooks - This is the way your system receives asynchronous notifications about events generated by users or businesses. Use webhooks to build a great UX or to feed your system with real-time data

I wish you luck in your explorations; have fun experimenting with Marqeta API!



Sandeep: Tell me a bit about the early part of your career.

Tom: I spent a decade helping to build start-ups focused on application and database software. This was where I learned how to sell and do business development. I was fortunate to be part of one company going public and another being sold to IBM.

Sandeep: What is something you learned during this time that helped you with consulting?

Tom: I began to appreciate how different customers achieved varying levels of success with the same foundational technology. This made me understand just how critical getting your team and process right can be.

Sandeep: This is something I only came to appreciate years into consulting, especially after the sale of my first consultancy to Capital One.I saw teams in different parts of the company trying to solve challenges like real-time messaging. Same corporate culture, same technology, same internal support mechanisms. Night and day outcomes.

Tom: We saw a lot of the same thing after selling our practice to EMC (sold to Dell in 2015). This is probably the thing I'm most proud of when it comes to the teams I've helped to build: the ability to perform well in a variety of contexts, sometimes in ways that inspires the client team to up their game as well.

Sandeep: Yes. It's particularly cool to see your team succeed in individual ways after an skills definitely translate into the corporate environment.

Tom: Totally. We have people who've stayed on at Dell and risen up the ranks, while others took the opportunity to become successful executives at other Fortune 100 companies....or to start their own agencies and startups.

Sandeep: We've both been around a while. My first consulting project was a Y2K thing for Cisco back in 1998. You've been around a little longer than that :). How do you think consulting has changed most during the past five years?

Tom: I think because there is so much infrastructure available now, consulting has become more delivery and outcome-oriented. A better blend of strategic and tactical. Public Cloud has also enabled velocity to increase at a pace unfathomable 5 years ago.

Sandeep: What has stayed the same?

Tom: It's still mostly about people. People who thrive on change and are focused on their personal and professional development. I love that this has not and will not's what I love about consulting.

Sandeep: I know you're adjusting your work style to COVID. You're still a dude who clearly prefers to drive an hour for a socially-distanced hike or outdoor meeting over Zoom any day of the week :) But personal styles aside, what is specifically compelling about a remote agency during the era of COVID?

Tom: Kunai has been remote for years, which gives them an inherent advantage. There is something about the communication and management styles that just works in a way that other organizations are still figuring out.

Sandeep: Yeah, I think what a lot of people fail to realize is that remote work isn't just office work over Zoom. it's an entirely new paradigm. There needs to be an understanding for asynchronous efficiency...and this just takes time and effort to develop. How do you approach remote work and family? What are you learning about separating work and personal time?

Tom: No matter what the form of interaction, Focus. Be present. Quality over quantity. The best weeks are the weeks where I proactively schedule work and personal time. Neil (Kunai's Head of Delivery) shared a great quote with me "With discipline comes freedom." When I am proactively addressing the majority of my professional and personal commitments, I find I earn a little flexibility. A little freedom.

Sandeep: Tell us about a business hero of yours that I may not have heard of before.

Tom: Paul O'Neill is someone you may not know. His work in both the public and the private sector created a profound impact

Sandeep: We are both over forty years old :). How have you learned how to work smarter during the past decade or so? What do you wish you knew about consulting when you were 25 that you know now?

Tom: Consultants want to make lasting change. Lasting change is often not the act of a single person. Today I work much harder bringing others along on the journey.

Sandeep: Last question. What are you doing here? :) Why join a small consulting company this late in your career when you could have a cushy job somewhere else?

Tom: I love a good challenge personally and professionally. When I turned 40, I decided I would run a 10K every Thanksgiving weekend and try to have my finishing time be less than my age. With the exception of one year where I did not run due to a health issue, I have met the goal. I also recently completed the Leadville 100 Mountain Bike race. So, I guess I'm here because I'm a glutton for punishment :) Jokes aside, our customers have a job to do and I intend to put Kunai in a position to execute flawlessly on their behalf. I love committing jointly to audacious goals for our customers and our business.

Keep Reading

See All →