Developer Tools

If you have signed up on Marqeta.com via the Public Sandbox button, you have access to a dashboard that provides tools for integrating with the Marqeta platform so that you can:

• Get API keys for your public sandbox.
• View a transaction’s history.
• Manage your webhooks.

For more about signing up and using the Public Sandbox, see API Quick Start and Introduction.

​

Get API keys for your public sandbox

Use API keys to set up authorization credentials that allow you to send requests to your public sandbox. For more information, see Authentication in the Core API Reference. To access your credentials and set up your public sandbox:

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Your API Key information is displayed here on the API Keys tab.

   Key Name	Usage
   Application token	Your username.
   Admin access token	Your password.
   Base URL	Prefix this value to your endpoint URL.

​

View a transaction’s history

You can view the lifecycle of a card token in your public sandbox using the interactive transaction timeline tool. All public sandbox accounts include access to the Transaction Timeline. The transaction timeline helps newcomers to the Marqeta platform quickly understand the role played by transaction flows in their integration, as well as in the broader payments space. It demonstrates line-by-line how individual transactions impact each other, and how they affect the account balance. To view a card token’s transaction history using the Transaction Timeline:

1. Simulate at least one transaction in your public sandbox.
2. Select the Public Sandbox button in the top navigation bar and sign in to your account.
3. Select the Transaction timeline tab in the side panel.
4. From the dropdown, select one of your card tokens from the list of existing active cards. The Transaction timeline tool automatically builds and displays a history of all the transactions completed on the selected card

• To view available and ledger balances for a transaction event, select the event in the event’s table.
• You can filter on transactions and copy them to your clipboard by using the action buttons available in each event row.

​

Manage your webhooks

Webhooks are real-time notifications to keep you informed of specific events that occur within your public sandbox or integration. For example, you could create a webhook to send state.activated events to your application’s webhook URL that would inform your cardholder when a card has been activated. You can manage webhooks in your sandbox from the Webhooks page. For information about working with webhooks in production, see About Webhooks. With your public sandbox, you can configure and manage up to five webhooks.

​

Add a webhook in sandbox

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. Select Add webhook.
4. In the Webhook details page, fill out the details for the webhook you wish to set up:

   Fields	Description
   Name string required	Descriptive name of the webhook. Allowable Values: 64 char max
   URL string required	URL of your webhook endpoint. If you do not have an endpoint for testing, Beeceptor provides a free online service. Allowable Values: - 255 char max - Must be HTTPS - Empty string not allowed
   Authentication username string required	Username for accessing your webhook endpoint. Allowable Values: 50 char max
   Authentication password string required	Password for accessing your webhook endpoint. Allowable Values: - 20-50 characters - Must contain at least one numeral - Must contain at least one lowercase letter - Must contain at least one uppercase letter - Must contain at least one of these symbols: @ # $ % ! ^ & * ( ) _ + ~ \ - = [ ] { } , ; : ’ ” . / < > ? `
   Custom headers object optional	Contains information about the webhook’s custom HTTP headers for outgoing calls. Allowable Values: See The config.custom_header object (request).

5. In the Event listeners tab, select the events you would like to webhook to listen for.
6. Select Save details to save your webhook configuration.

​

Test a webhook in sandbox

To test your webhook do the following:

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. Select the webhook you would like to test, this will open the webhook details page.
4. Select Send test event and check that a webhook event occurred on your webhook endpoint.

​

Disable a webhook in sandbox

You have the option of disabling an activated webhook that you do not want to use; you can always reactivate it later on if necessary. It is not currently possible to delete a webhook once it has been created.

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. In the list of webhooks, select the dropdown in the table’s State column. Select Disable.
4. Confirm you want to disable the webhook by selecting Disable on the popup notification.

Alternatively, you can select the webhook you would like to disable, and select the Disable webhook option from the Webhook details page.

​

To reactivate a disabled webhook

If you have previously disabled a webhook, you must reactivate it before the Marqeta platform will resume sending event notifications to the specified URL.

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. In the list of webhooks, select the dropdown in the table’s State column. Select Reactivate.
4. Confirm you want to disable the webhook by selecting Reactivate on the popup notification.

Alternatively, you can select the webhook you would like to disable, and select the Reactivate webhook option from the Webhook details page.

​

Update a webhook in sandbox

In order order to make changes to an existing webhook do the following:

1. Select the Public Sandbox**** button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. Select the webhook you want to update, this will open the Webhook details page.

Edit the webhook’s details, keeping the following field requirements in mind:

1. Select Save details to save your webhook configuration.

​

Manage event listeners

You can manage which Marqeta events you want your webhooks to listen to. You can add as many or as few events as you need to a webhook, then fine-tune your webhooks as your development progresses. For example, when starting out, you might want your application to listen for all event types. Later on, you might subscribe only to specific transaction events such as authorization.clearing and authorization.atm.withdrawal

1. Select the Public Sandbox button in the top navigation bar and sign in to your account.
2. Select the Webhooks tab in the side panel.
3. Select the webhook you want to update event listeners for, this will open the Webhook details page.
4. Select the Event listeners tab. A searchable, hierarchical list of all events you can listen on is displayed.
5. Select the Marqeta events you want this webhook to listen for. Select Save selected events.