PaymentNotice — Payment notification
"Payment was issued on 14 May 2026 for 1,250 USD." A simple notification, without line-by-line allocation detail — to point the recipient to the associated PaymentReconciliation.
Purpose
PaymentNotice is a short notification: the insurer informs the provider (or vice versa) that a payment has been issued for a given Claim. It is light, does not carry the line-by-line details — see PaymentReconciliation for that.
Key fields
| Field | Type | Cardinality | Role |
|---|---|---|---|
identifier | Identifier[] | 0..* | External identifiers. |
status | code | 1..1 | Mandatory. active, cancelled, draft, entered-in-error. |
request | Reference(Any) | 0..1 | Original Claim or request. |
response | Reference(Any) | 0..1 | Corresponding response (ClaimResponse). |
created | dateTime | 1..1 | Mandatory. Notice date. |
reporter | Reference(Organization | Practitioner | PractitionerRole) | 0..1 | Notice issuer. |
payment | Reference(PaymentReconciliation) | 0..1 | Detailed reconciliation. |
paymentDate | date | 0..1 | Effective payment date. |
payee | Reference(Organization | Practitioner | PractitionerRole) | 0..1 | Payment beneficiary. |
recipient | Reference(Organization) | 1..1 | Mandatory. Notification recipient. |
amount | Money | 1..1 | Mandatory. Paid amount. |
paymentStatus | CodeableConcept | 0..1 | Payment status (paid, cleared, returned). |
JSON example
Notification of 1250 USD payment to the hospital:
{
"resourceType": "PaymentNotice",
"id": "pn-2026-001",
"identifier": [{
"system": "urn:oid:1.2.34",
"value": "PN-2026-001"
}],
"status": "active",
"request": { "reference": "Claim/claim-2026-001" },
"response": { "reference": "ClaimResponse/claimresponse-2026-001" },
"created": "2026-05-15T11:00:00+02:00",
"reporter": { "reference": "Organization/insurer-x" },
"payment": { "reference": "PaymentReconciliation/pr-2026-005" },
"paymentDate": "2026-05-14",
"payee": { "reference": "Organization/hospital-1" },
"recipient": { "reference": "Organization/hospital-1" },
"amount": {
"value": 1250.00,
"currency": "USD"
},
"paymentStatus": {
"coding": [{
"system": "http://terminology.hl7.org/CodeSystem/paymentstatus",
"code": "paid"
}]
}
}Common pitfalls
- Including line-by-line detail — PaymentNotice is a short message. Detail goes in PaymentReconciliation.
- No
paymentlink — without a referenced reconciliation, the notice is blind: what does the amount correspond to? - Missing currency in
amount— EUR vs USD: costly ambiguity. - Confusing
payeeandrecipient— payee = who gets the money, recipient = who gets the notification (could be a third party, intermediary or office). activestatus without actual payment — creating a PaymentNotice before effective payment creates accounting noise.
Related resources
- Claim — payment request.
- ClaimResponse — insurer response.
- PaymentReconciliation — allocation detail.
- ExplanationOfBenefit — associated EOB.