Skip to main content
WEBHOOK
processing_status_updated
{
  "transaction": {
    "id": "txn_01JVY8Y4N9X2M6S5Q7T1",
    "messageId": "msg_01JVY8Y4N9X2M6S5Q7T1",
    "source": {
      "type": "external_submission",
      "externalSubmission": {
        "id": "sub_01JVY8Y4N9X2M6S5Q7T1",
        "displayName": "Customer message submission"
      }
    },
    "type": "transfer",
    "createdAt": "2026-04-07T20:11:42Z",
    "updatedAt": "2026-04-07T20:12:05Z",
    "status": "PENDING",
    "statusReason": null,
    "externalId": "e2e-20260407-000123",
    "relatedTransactionId": null,
    "amounts": {
      "debit": {
        "amount": "125000.00",
        "currency": "USD"
      },
      "credit": {
        "amount": "124975.00",
        "currency": "USD"
      },
      "fees": [
        {
          "type": "NETWORK_FEE",
          "label": "Network fee",
          "amount": "25.00",
          "currency": "USD"
        }
      ],
      "exchangeRate": "1.0000"
    },
    "debitInstrument": {
      "type": "ORIGINATOR",
      "originator": {
        "displayName": "Northwind Imports LLC",
        "accountNumber": "****9021"
      }
    },
    "creditInstrument": {
      "type": "BENEFICIARY_ACCOUNT",
      "beneficiaryAccount": {
        "id": "bfa_01JVY8Y4N9X2M6S5Q7T1",
        "displayName": "Contoso Treasury USD Account",
        "currency": "USD"
      }
    }
  },
  "metadata": {
    "programId": "prog_01JVY8P4Q9F2M6S5Q7T1"
  }
}

Authorizations

​
X-Meridian-Signature
string
header
required

Meridian HMAC header authentication.

Required headers:

  • X-Meridian-Api-Key
  • X-Meridian-Program-Id
  • X-Meridian-Timestamp
  • X-Meridian-Signature

Headers

​
X-Meridian-Resource-Type
string
required
Allowed value: "transaction"
​
X-Meridian-Event-Type
string
required
Allowed value: "processing_status_updated"
​
X-Meridian-Program-Id
string
required

Identifies your Meridian program. Required on all requests but not included in the canonical signing string.

Required string length: 8 - 128
​
X-Meridian-Api-Key
string
required

Public client key identifier used to look up the HMAC secret

Required string length: 8 - 128
​
X-Meridian-Timestamp
string<date-time>
required

RFC 3339 UTC timestamp used in the HMAC signing string and replay protection. Requests outside the accepted clock skew window should be rejected.

​
X-Meridian-Signature
string
required

HMAC-SHA256 signature of the canonical signing string. Recommended format: sha256={hex_digest}

Pattern: ^sha256=[A-Fa-f0-9]{64}$

Body

application/json
​
transaction
object
required
​
metadata
object
required

Response

200

Success