How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Marqeta Payments API

// Conditional snippet for beta or internal contentinclude::../../maturity-admonition-banner.adoc[]Use the payments endpoints to create and retrieve payments made on a >, release payment holds, or transition payment statuses.A payment is an amount paid toward an account balance to reduce the total amount owed on the account.For more on payments, see >.To receive webhook notifications when ACH payment transition events occur, see > in Event Types.Creating a payment triggers the creation of a > belonging to the `PAYMENT` group.For more on payment journal entries, see > in the About Credit Account Journal Entries guide.

Marqeta Payments API is one of 81 APIs that Marqeta publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Payments. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 5 paths, and defines 15 schemas. It is described by OpenAPI 3.0.3, at version 3.0.39.

Requests are made against a single base URL, /v3.

6 operations 5 paths 15 schemas 2 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0.39
Base URL
https://sandbox-api.marqeta.com/v3
Authentication
HTTP Basic
Contact
Terms of Service
Resource Areas
1

Authentication & Security 1

Marqeta Payments API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (mqAppAndAccessToken). By default, every request must be authenticated.

Paths & Operations 6

Across 5 paths, the API surfaces 6 operations — 2 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

Payments 6

// Conditional snippet for beta or internal content include::../../maturity-admonition-banner.adoc[] Use the payments endpoints to create and retrieve payments made on a , release…

GET
/accounts/{account_token}/payments
List account payments
listPayments 7 params → 200default
POST
/accounts/{account_token}/payments
Create account payment
createPayment 1 param body → 201default
GET
/accounts/{account_token}/payments/{payment_token}
Retrieve account payment
retrievePayment 2 params → 200default
POST
/accounts/{account_token}/payments/{payment_token}/releasehold
Release payment hold
releasePaymentHold 2 params → 200default
POST
/accounts/{account_token}/payments/{payment_token}/transitions
Transition account payment status
transitionPayment 2 params body → 201default
POST
/webhooks/{event_type}/{resource_token}
Resend credit event notification
resendWebhookEvent 2 params → 200default

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are PaymentDetailResponse (22 properties), PaymentCreateReq (9 properties), PaymentsPage (5 properties), PaymentTransitionResponse (5 properties). Each schema is shown below with its type and property counts.

PaymentsPage
object
Returns paginated payments
5 properties 5 required
RefundDetailsResponse
object
Contains details for a refund.
3 properties 3 required
PaymentTransitionReq
object
Request used to transition the status of a payment.
4 properties 1 required
CurrencyCode
string
Valid three-digit link:https://www.iso.org/iso-4217-currency-codes.html[ISO 4217 currency code, window="blank"].
PaymentDetailResponse
object
Response containing payment details with transition history.
22 properties 11 required
PaymentStatus
string
Current status of the payment or refund.
ReturnedDetails
object
Contains information on a returned payment.
2 properties 2 required
PaymentAllocationResponse
object
Object containing payment allocation information.
2 properties 2 required
WebhookEventResendContainerResponse
object
Contains information about a webhook event.
1 property
RefundMethod
string
Payment instrument used to issue the refund.
RefundStatus
string
Current status of the refund.
RefundDetails
object
Contains details for a refund.
2 properties 2 required
PaymentCreateReq
object
Object that is created when a user pays a portion or all of their statement balance. Applies to immediate payments only. Once the value is set to ACTIVE, it ca…
9 properties 4 required
Error
object
2 properties
PaymentTransitionResponse
object
Response containing payment transition information.
5 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

marqeta-payments-api-openapi.yml Raw ↑

Other APIs Marqeta publishes across the network.

Marqeta Webhooks
Marqeta Risk Controller / Real-Time Decisioning
Marqeta accepted countries API
Marqeta Account API
Marqeta Account Bundle Transitions API
Marqeta Account Cards API
Marqeta Account Documents API
Marqeta account holder groups API
Marqeta Account Refunds API
Marqeta Account Rewards API
Marqeta Account Signup Bonus API
Marqeta Account Transitions API
Where this information came from

This is an independent, third-party profile of Marqeta Payments API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.