APPLICATION_TOKEN

ADMIN_ACCESS_TOKEN

BASE_URL

USER_TOKEN

CARD_PRODUCT_TOKEN

CARD_TOKEN

TRANSACTION_TOKEN

TRANSACTION_AMOUNT

GPA_ORDER_TOKEN

GPA_UNLOAD_TOKEN

Gain insights into Marqeta's Core API, explore resource management, simulate transactions, and create a simple application. Discover recommendations and deepen your Marqeta integration skills.

Creating Payment Card Programs using Marqeta API in JavaScript.png

marqeta-final.tar.gz

Marqeta React App

Marqeta is a modern card issuing and transaction processing platform that streamlines business payments by working with card networks and issuing banks to issue cards, authorize transactions, and communicate with settlement entities.

In this course, you will learn about Marqeta’s Core API, its resources, and the relationships among them. Next, you will get to learn how to create and manage these resources and their relevant functionalities. Then, you will learn how to simulate transactions and their reversals in a sandbox test environment using a Marqeta payment card. In addition to this, you will also learn how to create a simple application using the Marqeta API integration. Finally, this course will provide some recommendations and resources for further exploration of Marqeta’s Core API and its integration.

After completing this course, you will be able to create a simple application with the Marqeta API integration and be able to implement a majority of its functionality.

Creating Payment Card Programs using Marqeta API in JavaScript

A **card** is a payment card that's owned by a user. It can either be a physical or a virtual card. The behavior and the attributes of the card are defined by the card product object associated with it. We can also define the attributes of the card inside the card object. In that case, the definition inside the card object will take precedence over the definition inside the card product object.

In this lesson, we'll learn how to create and update a Marqeta payment card.

# Create a card

We can create a Marqeta payment card by making a `POST` request to the `{BASE_URL}/cards` endpoint. We can provide basic information about the card in the request's body. This includes the shipping information. We also need to specify the `user_token` of the card owner and the `card_product_token` of the card product that controls the card. Therefore, we need to create a user and a card product before we create a new Marqeta card.

Request parameters

align-center

> **Note:** Please refer to the [Additional Parameters and Response Fields](https://www.educative.io/courses/creating-payment-card-programs-using-marqeta-api-in-javascript/additional-parameters-and-response-fields#Create-a-card) lesson for details of the `expiration_offset`, `fulfillment`, and `activation_actions` objects.

After we've entered the values, click the "Run" button in the code widget below to see the output.

Learn what a Marqeta card is as well as how to create and update it.

Parameter	Type	Category	Description
`show_cvv_number`	Boolean	Optional	`true` to show the CVV2 number in the response, otherwise `false` Note: This is a query parameter.
`show_pan`	Boolean	Optional	`true` to show the card’s PAN (primary account number) in the response, otherwise `false` Note: This is a query parameter.
`card_product_token`	String	Optional	Token of the card product
`expedite`	Boolean	Optional	`true` when we want to request the fulfillment provider to expedite card processing, otherwise `false` Default value: `false`
`metadata`	Object	Optional	Adds metadata provided by the customer to the card Allowable values: Maximum 20 key-value pairs allowed Format: "my_name_1": "my_value_1"
`expiration_offset`	Object	Optional	Defines the duration for card validity after issuance
`token`	String	Optional	Unique token of the card Length: 1–36 characters Note: If not specified, the system generates one automatically. This value cannot be updated once set.
`user_token`	String	Mandatory	Unique token of the card user
`fulfillment`	Object	Optional	Contains shipping information and the physical characteristics of the card
`reissue_pan_from_card_token`	String	Optional	Reissues the specified card and assigns the new card the same PAN and PIN (personal identification number) but a new expiration date and CVV2 number Maximum length: 36 characters
`translate_pin_from_card_token`	String	Optional	Assigns the newly created card the same PIN as the specified card Maximum length: 36 characters Note: Both cards must belong to the same user. Additionally, `reissue_pan_from_card_token` must not be set.
`activation_actions`	Object	Optional	Contains actions to perform at card activation Note: The fields in this object are mutually exclusive.
`bulk_issuance_token`	String	Optional	Token of the bulk card order to link the card to Note: This field cannot be updated once set. Maximum length: 36 characters

Introduction

Users

Card Products

Cards

General Purpose Accounts

Transactions

Marqeta API Integration in React

Conclusion

Appendix

Create and Update Cards

Create a card

Request parameters