{
"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"
}
}Webhooks
Processing Status Updated
Learn when the processing status updated webhook is sent and what data it includes.
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
Meridian HMAC header authentication.
Required headers:
- X-Meridian-Api-Key
- X-Meridian-Program-Id
- X-Meridian-Timestamp
- X-Meridian-Signature
Headers
Allowed value:
"transaction"Allowed value:
"processing_status_updated"Identifies your Meridian program. Required on all requests but not included in the canonical signing string.
Required string length:
8 - 128Public client key identifier used to look up the HMAC secret
Required string length:
8 - 128RFC 3339 UTC timestamp used in the HMAC signing string and replay protection. Requests outside the accepted clock skew window should be rejected.
HMAC-SHA256 signature of the canonical signing string. Recommended format: sha256={hex_digest}
Pattern:
^sha256=[A-Fa-f0-9]{64}$Body
application/json
Response
200
Success