Meld.io · Schema
PaymentTransactionListResponse20250304
Data IntegrationFintechAPI PlatformStablecoinsDigital AssetsEnterprise
Properties
| Name | Type | Description |
|---|---|---|
| count | integer | Number of payment transactions returned. |
| remaining | integer | Number of payment transactions before/after this page, depending the direction this page was selected. |
| totalCount | integer | Total number of payment transactions. |
| transactions | array | List of transactions |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/meld/json-schema/meld-payment-transaction-list-response20250304-schema.json",
"title": "PaymentTransactionListResponse20250304",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/meld-retail-ramp-api-openapi.yml#/components/schemas/PaymentTransactionListResponse20250304",
"type": "object",
"properties": {
"count": {
"type": "integer",
"format": "int32",
"description": "Number of payment transactions returned."
},
"remaining": {
"type": "integer",
"format": "int32",
"description": "Number of payment transactions before/after this page, depending the direction this page was selected."
},
"totalCount": {
"type": "integer",
"format": "int32",
"description": "Total number of payment transactions."
},
"transactions": {
"type": "array",
"description": "List of transactions",
"items": {
"$ref": "#/$defs/SearchedPaymentTransactionOutput20250304"
}
}
},
"$defs": {
"CryptoDetails20250304": {
"type": "object",
"properties": {
"blockchainTransactionId": {
"type": "string",
"description": "The transaction id on the blockchain"
},
"chainId": {
"type": "string",
"description": "A unique identifier that represents a blockchain network. The chainId of a particular network is standard everywhere."
},
"destinationWalletAddress": {
"type": "string",
"description": "The wallet address that the crypto is sent to. This is usually the user's wallet address for buy and transfer transactions, and the onramp's wallet address for sell transactions."
},
"institution": {
"type": "string",
"description": "The institution used to execute the transaction. Only applicable for transfers currently."
},
"networkFee": {
"type": "number",
"description": "This fee is paid to cryptocurrency miners, which are the systems that process the transactions"
},
"networkFeeInUsd": {
"type": "number",
"description": "This network fee in USD"
},
"partnerFee": {
"type": "number",
"description": "The partner fee amount"
},
"partnerFeeInUsd": {
"type": "number",
"description": "The partner fee in USD"
},
"sessionWalletAddress": {
"type": "string",
"description": "The wallet address passed into the /widget endpoint, typically of the user. This will often be the same as either the sourceWalletAddress or the destinationWalletAddress."
},
"sourceWalletAddress": {
"type": "string",
"description": "The wallet address that the crypto comes from. This is usually the onramp's wallet address for buy transactions, and the user's wallet address for transfer and sell transactions."
},
"swapFee": {
"type": "number",
"description": "The swap fee amount charged by the swap provider for ramp+swap transactions"
},
"swapFeeInUsd": {
"type": "number",
"description": "The swap fee in USD"
},
"totalFee": {
"type": "number",
"description": "The total amount of fees that will be charged"
},
"totalFeeInUsd": {
"type": "number",
"description": "The total fee in USD"
},
"transactionFee": {
"type": "number",
"description": "The fee amount charged by the service provider to process your customer's purchase"
},
"transactionFeeInUsd": {
"type": "number",
"description": "The transaction fee in USD"
}
}
},
"CustomerAddressDetails": {},
"CustomerAddressOutput": {
"type": "object",
"properties": {
"addressDetails": {
"description": "Address details",
"allOf": [
{
"$ref": "#/$defs/CustomerAddressDetails"
}
]
},
"type": {
"type": "string",
"description": "Address type such as BILLING, SHIPPING, RESIDENCE, etc.",
"enum": [
"BILLING",
"SHIPPING",
"RESIDENCE"
]
}
}
},
"CustomerName": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "Your customer's first name"
},
"lastName": {
"type": "string",
"description": "Your customer's last name"
}
}
},
"CustomerOutput": {
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "Your Account Id"
},
"addresses": {
"type": "array",
"description": "Your Customer's addresses, such as billing, shipping, etc.",
"items": {
"$ref": "#/$defs/CustomerAddressOutput"
}
},
"email": {
"type": "string",
"description": "Your Customer's email address"
},
"externalId": {
"type": "string",
"description": "Your optionally supplied Id for your Customer, e.g. a Customer Id in your system"
},
"id": {
"type": "string",
"description": "Meld's internal Id for the Customer"
},
"name": {
"description": "Your Customer's name",
"allOf": [
{
"$ref": "#/$defs/CustomerName"
}
]
},
"phone": {
"type": "string",
"description": "Your Customer's phone number"
},
"serviceProviders": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "A map of Service Providers and service provider IDs for this Customer"
},
"status": {
"type": "string",
"description": "ACTIVE or INACTIVE, may not be set"
}
}
},
"MultiFactorAuthorizationStatusOutput": {
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "How the card details were authorized",
"enum": [
"SMS",
"CARD",
"EMAIL",
"THREE_DS"
]
},
"submitted": {
"type": "boolean",
"default": false,
"description": "Return ***True*** if the information was submitted"
},
"successful": {
"type": "boolean",
"default": false,
"description": "Return ***True*** if the submitted information is a match"
},
"url": {
"type": "string",
"description": "URL used to perform authorization (if applicable)"
}
}
},
"PaymentDetails": {
"type": "object",
"properties": {
"authAmount": {
"type": "number",
"description": "The amount authorized to be charged (must be greater than the amount intended to be collected.) Note that the number of digits with a decimal point varies with the currency. Reference the list of active codes of official ISO 4217 currency names."
},
"captureAmount": {
"type": "number",
"description": "The amount captured (can be less than the amount intended to be collected.) Note that the number of digits with a decimal point varies with the currency. Reference the list of active codes of official ISO 4217 currency names."
}
}
},
"SearchedPaymentTransactionOutput20250304": {
"type": "object",
"properties": {
"accountId": {
"type": "string",
"description": "Your account Id"
},
"apiAccessProfileId": {
"type": "string",
"description": "The id of the API access profile used to create this transaction. May be null if the transaction was not created via an endpoint that uses an API key for authentication. For example, when imported as a result of a webhook from a service provider."
},
"countryCode": {
"type": "string",
"description": "The ISO 3166 2-digit country code."
},
"createdAt": {
"type": "string",
"format": "date-time",
"description": "An ISO 8601 DateTime at which the object was created."
},
"cryptoDetails": {
"description": "Details of the crypto currency purchase, sale, or transfer",
"allOf": [
{
"$ref": "#/$defs/CryptoDetails20250304"
}
]
},
"customer": {
"description": "Your customer's details",
"allOf": [
{
"$ref": "#/$defs/CustomerOutput"
}
]
},
"description": {
"type": "string",
"description": "An arbitrary string which you can attach to this transaction. It is displayed when in the web interface alongside the charge."
},
"destinationAmount": {
"type": "number",
"description": "The destination amount of the transaction, e.g. the amount of crypto currency purchased"
},
"destinationCurrencyCode": {
"type": "string",
"description": "Three-letter ISO currency code. Must be a supported currency"
},
"externalCustomerId": {
"type": "string",
"description": "Your unique identifier for your customer. If maintaining your own customer management system this can also be used for tracking customer activity."
},
"externalReferenceId": {
"type": "string",
"description": "Your optional reference id provided during transaction creation"
},
"externalSessionId": {
"type": "string",
"description": "The external Id of the session."
},
"externalSubaccountCustomerId": {
"type": "string",
"description": "Optional external identifier for the sub-account customer this transaction belongs to. Used for tracking when multiple businesses operate under one Meld account. A sub-account customer must be created first before it can be referenced."
},
"fiatAmountInUsd": {
"type": "number",
"description": "The fiat amount of the transaction in usd"
},
"id": {
"type": "string",
"description": "Unique identifier for this transaction"
},
"isImported": {
"type": "boolean",
"description": "Return ***True*** if this transaction was initiated outside Meld"
},
"isPassthrough": {
"type": "boolean",
"description": "Return ***True*** if the passthrough credentials were used"
},
"key": {
"type": "string",
"description": "Pagination key, may be used with the \"after\" parameter in search requests. Only set and relevant for paginated calls"
},
"multiFactorAuthorizationStatus": {
"type": "array",
"description": "The transaction required multi-factor authentication methods, and their current status. When required, must be approved for the purchase tobe completed successfully.",
"items": {
"$ref": "#/$defs/MultiFactorAuthorizationStatusOutput"
},
"uniqueItems": true
},
"orderId": {
"type": "string",
"description": "Unique identifier for the order associated with this transaction, when applicable"
},
"parentPaymentTransactionId": {
"type": "string",
"description": "The Id of the associated object for this line item"
},
"passthroughReference": {
"type": "string",
"description": "The unique reference you use to identify the partner on whose behalf you created this transaction. This might be a String or UUID in your system to identify a merchant or partner. This is needed so that you can associate passthrough transactions to your partners who may not be registered with Meld"
},
"paymentDetails": {
"description": "payment details",
"allOf": [
{
"$ref": "#/$defs/PaymentDetails"
}
]
},
"paymentMethodType": {
"type": "string",
"description": "Payment Method type used for this transaction."
},
"serviceProvider": {
"type": "string",
"description": "The service provider used for this transaction"
},
"serviceProviderCreatedAt": {
"type": "string",
"format": "date-time",
"description": "The ISO 8601 DateTime when the transaction was created on the service provider's side"
},
"serviceProviderDetails": {
"type": "object",
"additionalProperties": {},
"description": "The service provider's details"
},
"serviceProviderTransactionUrl": {
"type": "string",
"description": "A link to the resource on the Service Provider, may not be present"
},
"serviceTransactionId": {
"type": "string",
"description": "The service provider's unique identifier for this transaction"
},
"sessionClientTags": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "A map of client tags"
},
"sessionId": {
"type": "string",
"description": "The Id of the session."
},
"sourceAmount": {
"type": "number",
"description": "The amount of the transaction"
},
"sourceCurrencyCode": {
"type": "string",
"description": "Three-letter ISO currency code. Must be a supported currency"
},
"status": {
"type": "string",
"description": "The current status of the transaction"
},
"subaccountCustomerId": {
"type": "string",
"description": "Optional Meld customer id used to track the business sub-account this transaction belongs to when multiple businesses operate under one Meld account."
},
"transactionType": {
"type": "string",
"description": "The transaction's type"
},
"updatedAt": {
"type": "string",
"format": "date-time",
"description": "Time at which the object was last updated. Measured in seconds since the Unix epoch."
}
},
"required": [
"createdAt",
"id",
"serviceProvider",
"sessionId",
"status",
"transactionType",
"updatedAt"
]
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/meld-payment-transaction-list-response20250304"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.