Reference · Sandbox

Simulate an inbound credit

Land funds on a receiving endpoint in the sandbox, standing in for the external rail.

POST/v1/sandbox/inbound-credits

Authorization: Bearer ak_test_… · Application API key

Idempotency-Key: <uuid> · required

Try it

This operation writes. Compose it in the playground, where you pick refs from objects you hold and pass one human check before it fires — then follow it back here.

Key capabilities

SandboxInboundCreditSimulationCreate

Sharp edges

This is the one simulated seam. The credit's arrival stands in for the rail; everything downstream of it — ledger, balances, fees — is the real engine.

Wire receipt

Captured from the real gateway by the scenario suite; nothing here is composed by hand.

The sandbox stands in for the outside world at exactly one seam: value arriving. Everything after this call is the real platform.

Request

POST /v1/sandbox/inbound-credits
Authorization: Bearer ak_test_…
Idempotency-Key: 00000000-0000-0000-0000-000000008403
Content-Type: application/json

{
  "accountRef": "f420a7a0-db4c-39e4-b9de-a76aa76a1ea7",
  "endpointRef": "14fd5416-ef87-3487-9132-2c49f5884884",
  "holdingRef": "018f605c-ef4d-31a0-87be-60ac7467610c",
  "valueUnit": {
    "kind": "fiat",
    "currency": "NGN"
  },
  "amountMinorUnits": "2500"
}

Response · 202

{
  "status": 202,
  "body": {
    "simulation": {
      "value": {
        "simulationRef": "e573bc24-0773-35cc-9ba5-77a328246505",
        "acceptedAt": "2026-07-13T20:08:19.628931Z",
        "stage": "EvidencePublished",
        "revision": 2,
        "materialFingerprint": "fp:sandbox-simulation-material:2128b7895d7f847f363f859516c62e04bb145e7e504ace6f07a9ec4afb18b1f6",
        "targetAccountRef": "f420a7a0-db4c-39e4-b9de-a76aa76a1ea7",
        "targetEndpointRef": "14fd5416-ef87-3487-9132-2c49f5884884",
        "targetHoldingRef": "018f605c-ef4d-31a0-87be-60ac7467610c",
        "valueUnit": {
          "kind": "fiat",
          "currency": "NGN"
        },
        "amountMinorUnits": "2500",
        "requestedBy": "e2efd3c3-b2e9-39a0-96a7-df42b898c70e",
        "accountsPostingReceiptRef": "3b99ce41-e006-5f72-a3c3-c5dc2d482213",
        "eventReceiptRefs": [
          "fb228871-bde5-3acf-8114-ef139495a7c2"
        ]
      },
      "freshness": "Current",
      "visibility": "Full",
      "evidence": [
        {
          "receiptRef": "e2efd3c3-b2e9-39a0-96a7-df42b898c70e",
          "source": "VaeRuntime"
        },
        {
          "receiptRef": "3b99ce41-e006-5f72-a3c3-c5dc2d482213",
          "source": "Accounts"
        },
        {
          "receiptRef": "fb228871-bde5-3acf-8114-ef139495a7c2",
          "source": "EventRuntime"
        }
      ]
    }
  },
  "evidence": [
    {
      "receiptRef": "e2efd3c3-b2e9-39a0-96a7-df42b898c70e"
    },
    {
      "receiptRef": "3b99ce41-e006-5f72-a3c3-c5dc2d482213"
    },
    {
      "receiptRef": "fb228871-bde5-3acf-8114-ef139495a7c2"
    }
  ]
}

captured 2026-07-13 · gateway 0.1.0 · First credit · Simulate an inbound credit

Simulate an inbound credit

Key capabilities

Sharp edges

Wire receipt

See also