v1

latestOpenAPI 3.1.0UNLICENSED2026-07-2613101.1 MB

Simulations

Simulate a card refund authorisation clearing

Simulates a card refund authorisation clearing.

This endpoint is for testing purposes only and won't work in production.

post/cards/simulations/refund/authorization/clearing

Query parameters

accountIdstring required

The ID of the account to work with.

Example:F50091

Request body

precedingRelatedTransactionTokenstring required

The token of the transaction to work with.

amountnumber required

The amount.

cardIdstring uuid

Optional. When supplied, em-cards-api routes the simulation to the Marqeta tenant matching the card's product market (UK or US). Omit to keep the legacy UK routing.

Example request

{
  "precedingRelatedTransactionToken": "9d3dee7c-19df-4b71-bbb9-521bb04307bf",
  "amount": 10,
  "cardId": "f16ba382-eb42-481a-b08f-c57bdc9aae24"
}

Response

Created

Example response

{
  "transaction": {
    "acquirerFeeAmount": "1.2",
    "type": "authorization.clearing",
    "state": "COMPLETION",
    "token": "7bff9f48-8c68-4937-917a-bf7cf4f0de27",
    "userToken": "f0d5cae0-fb3f-417f-8f1c-51c5fb66259a",
    "cardToken": "3c5d4203-99dc-4bbb-a8c4-e5c61fbe563a",
    "requestAmount": "10.0",
    "response": {
      "code": "0000",
      "memo": "Approved or completed successfully"
    },
    "createdTime": "2022-12-06T21:41:48Z",
    "userTransactionTime": "2022-12-06T21:41:49Z",
    "settlementDate": "2022-12-06T21:41:50Z",
    "amount": "10.0",
    "gpa": {
      "ledgerBalance": "240.0",
      "availableBalance": "240.0",
      "impactedAmount": "-10.0"
    },
    "currencyCode": "GBP",
    "currencyConversion": {
      "originalAmount": "10.0",
      "conversionRate": 1,
      "originalCurrencyCode": "826"
    },
    "precedingRelatedTransactionToken": "8a6d911e-cb3d-41d2-b843-5f9dc97d503c",
    "network": "VISA",
    "subnetwork": "VISANET",
    "cardAcceptor": {
      "postalCode": "33705",
      "mid": "000000000011111",
      "mcc": "6411",
      "name": "Card Acceptor Name",
      "city": "Seattle",
      "state": "WA",
      "countryCode": "USA"
    }
  }
}