Integration Verification
Marqeta drives the certification of your integration by gathering key data points about your program that describe how you will leverage the Marqeta platform to build your card program configuration and serve your customers. It’s vital that you review these data points to confirm their accuracy.
Marqeta provides best practices and ways to resolve potential issues so you can configure the Marqeta platform to best solve your business needs.
Step 1 — Technical advisement
Copy section link
By this step, you should have started the due diligence process. As you set up your integration with the Marqeta platform, your Marqeta Delivery Representative will provide customized recommendations for your card program such as the examples below:
| Feature | Travel / Supplier Payments | Expense Management |
|---|---|---|
Card product |
|
|
AVS |
Enabled, decline on postal code mismatch and on address mismatch |
Enabled, decline on postal code mismatch, do not decline on address mismatch |
User and card structure |
Flat, user/card 1:1 = each user will have a card, user will include address for end user whose bill is to be paid |
Parent:child, business object = downstream customer, child object = employees of the business who are authorized users |
Card ordering and activation |
Activate upon issue |
Fulfilled via full-service mail with personalized carriers, to be activated via IVR or in-app |
Card presentment |
No human presentment, only machine to machine |
Human presentment |
Funding |
Managed JIT, creating velocity controls for max spend at card creation |
Gateway JIT, limiting approvals based on balance loaded and other company determinations |
Default authorization control behavior |
Deny all, add specific MCCs in the travel space to the allow list |
Allow all, add the issuing bank’s MCC list to the deny list |
Step 2 — Private sandbox access
Copy section link
After you complete the technical advisement process, Marqeta provisions your sandbox environment, provides you with access keys, and adds your system’s IP addresses to the allow list. If you need to use PCI compliance widgets or Marqeta.js, Marqeta provisions them for you at this time.
Step 3 — Onboarding checkpoints
Copy section link
Throughout the early stages of the development process, your Marqeta Delivery Representative holds weekly onboarding checkpoint meetings. In addition, you will be invited to a private Slack channel where your questions will be answered by directing you to relevant documentation.
During this time, you should be creating the basic components of your card program. The table below lists who is responsible for some common tasks.
| Responsibility Matrix | Powered | Managed |
|---|---|---|
Creating and configuring card products |
You |
Marqeta |
Creating and managing users |
You |
You |
Creating and managing cards |
You |
You |
Creating and managing spend controls at the card-product level |
You |
Marqeta |
Creating and managing controls at the user and card level |
You |
You |
Step 4 — Simulating transactions
Copy section link
Before proceeding to final certification, Marqeta expects you to simulate, at a minimum, the following transactions before proceeding to final certification.
| Simulation | Endpoint and Method |
|---|---|
Create 50 users and cards |
POST /users POST /cards |
Simulate 15 authorizations |
POST /simulate/authorization |
Simulate 15 clearings |
POST /simulate/clearing |
For more information, see Users, Cards, and Simulating Transactions.
Step 5 — Integration certification
Copy section link
Just-in-Time (JIT) Funding certification
Copy section link
Note
Skip JIT Funding certification if your card program configuration does not include JIT funding.Certification is a critical step when integrating with the Marqeta platform, because this is when your Delivery Representative verifies that transactions are created and processed accurately, and that certain features such as JIT Funding and card fulfillment have been configured per the technical advisement in Step 1.
Marqeta will work with you to create data in your private sandbox that is required to complete the JIT Funding certification tests. For example, these tests require transactions involving users with specific balances that are expected to fail in certain cases. Your verification tests will be conducted at a convenient, prescheduled time. Technical team members from both Marqeta and your team should be available to troubleshoot any issues that arise.
| JIT Funding Certification Test | Powered | Managed |
|---|---|---|
Providing details about your gateway endpoint for sandbox and production environments |
You |
You |
Configuring gateways and card products |
You |
Marqeta |
Examining test case responses |
You |
Marqeta |
Conducting test authorizations against your sandbox gateway endpoint |
You |
Marqeta |
Creating test users and cards by card program configuration |
You |
Marqeta |
Conducting test transactions against your sandbox gateway endpoint |
You |
Marqeta |
Final check
Copy section link
Marqeta certifies your readiness by answering questions like the following:
-
Does your sandbox environment match what is expected in production?
-
Have all configurations been implemented correctly?
-
Have you successfully simulated the necessary transactions?
-
Is the default authorization behavior correct?
-
Are the active card limits correct?
-
Does your card product have the correct funding source (if you are using JIT Funding)?
-
Are bulk orders generated correctly (if you are using Marqeta’s card fulfillment service)?
-
Are you adhering to the expected KYC behaviors?
-
Are all necessary PCI compliance widgets deployed as expected?
After you successfully pass the certification, you are ready to start migrating your code to the production environment.
Step 6 — Go live
Copy section link
The comprehensive security scan of your production environment, reserve funding, and card fulfillment is complete. Marqeta has provided you with production credentials to transition your card program configuration to a live environment.
As referenced in the signed contract, your card program configuration is now considered to be in "Go live" state.
Step 7 — Live testing
Copy section link
A few tasks remain before your program is ready to launch:
-
If your card program includes either physical or virtual cards that need to be displayed, you must produce and approve the card art in accordance with the card network and issuing bank guidelines.
-
If your card program includes physical cards, you may want to schedule fulfillment orders to be able to reliably distribute cards to your cardholders.
Your Marqeta Delivery Representative will assist you with performing User Acceptance Testing in your live environment, focusing on authorizing and clearing transactions. Once both parties are adequately satisfied, your card program configuration will be ready for launch.