Description and Details
This API is used to validate a domestic payment request against a previously issued access consent. It confirms that the consent is valid, active, and authorized to perform the specified payment, and checks whether the payment details are correct and compliant with policy.
Endpoint
https://api-dev-isolution.xyz/opentest/v1/access-consent/{consent_id}/domesticpayment-validation
Verb Method
POST
Headers Request Parameters
| Header Key | Value | Description |
|---|---|---|
| Content-Type | application/json | Specifies JSON payload format |
| Accept | application/json | Expected response format |
| Authorization | Bearer {token} | OAuth 2.0 Bearer token |
Body Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| debtorAccount | string | Yes | Account number or ID of payer |
| creditorAccount | string | Yes | Account number or ID of payee |
| amount | string | Yes | Amount to transfer |
| currency | string | Yes | ISO currency code (e.g., PKR, USD) |
| paymentDate | string | Yes | Scheduled payment date in ISO 8601 format |
| paymentReference | string | No | Optional reference message |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| valid | boolean | Indicates whether the payment is valid |
| message | string | Human-readable message describing the result |
| consentStatus | string | Current status of the consent (e.g., Authorised) |
HTTP Codes
| Code | Meaning |
|---|---|
| 200 | OK – Validation successful |
| 400 | Bad Request – Missing or invalid parameters |
| 401 | Unauthorized – Token missing or invalid |
| 403 | Forbidden – Consent not authorized |
| 404 | Not Found – Consent ID does not exist |
| 500 | Internal Server Error |