Built by the community
Navigation
Metrics
Program
Service DeskPricingPoliciesDocument RepositoryLive Ecosystem
Developer Docs
TPP — Open Finance StandardsLFI — Integration GuideAPI SpecsKnowledge BaseRelease Notes & Erratas
NewsGitHub
Validate · Enforce · Trust

Payment Refunds — Requirements v2.12 min read

The tables below list the rules that apply to the Payment Refunds endpoint. The Hub validates authorization and consent permissions before calling your Ozone Connect server — your LFI is responsible for retrieving and returning the debtor's account details.

01 Endpoint

Get Refund

GET/payment-consents/{consentId}/refund
#
Condition
Rule
1
Refund account request received from Hub
Return 200 with a data object containing refundAccount. The refundAccount must include the debtor's schemeName (always IBAN), identification (the debtor's IBAN), and name (an object with en or ar).
2
Account is blocked from receiving payments — temporary
Return 403 with errorCode: Consent.AccountTemporarilyBlocked and errorMessage: The debtor account is blocked from receiving payments. Applies when the block is temporary — e.g. account status is Suspended, or the account is otherwise unable to receive a credit transaction refund on a transient basis.
3
Account is blocked from receiving payments — permanent
Return 403 with errorCode: Consent.PermanentAccountAccessFailure and errorMessage: The debtor account is blocked from receiving payments. Applies when the block is permanent — e.g. account status is Closed, Deceased, or Unclaimed.