Scheduled Payments
Retrieve information about Scheduled Payments of a bank account
Get Scheduled Payments by Account ID
This method fetches the scheduled payments information of the specified account through the Account ID included in the provided Consent ID.
Endpoint details
Endpoint URL | Method | Authentication requirements |
---|---|---|
/v1/api/observice/scheduledPaymentsById | POST | 1. clientId 2. clientCode 3. signature 4. Authorization Bearer: Token |
Sample request
{
"dateTimeStamp": "YYYY-MM-DDTHH:MM:SS",
"requestID": "Enter_Request_Id",
"merchantId": "Enter_Merchant_Id",
"banks": [
{
"code": "Enter_Bank_Code",
"consentId":"Enter_Consent_Id",
"accountId": "Enter_Account_Id"
}
]
}
Request description
JSON Tag | Description | Data type |
---|---|---|
DateTimeStamp Mandatory | Stamp denoting the date and time of the request | String |
RequestID Mandatory | Unique request identification | String |
merchantId Mandatory | Unique merchant identification | String |
banks Mandatory | Array of banks and consents | Object |
code Mandatory | Unique bank identification code | String |
consentId Mandatory | Unique consent identification | String |
accountId Mandatory | Unique account identification as per the consent | String |
Sample response
{
"success": true,
"payload": [
{
"code": "Bank_Code",
"data": {
"accountId": "Account_Id",
"scheduledPayment": [
{
"scheduledPaymentId": "Scheduled_Payment_Id",
"scheduledPaymentDateTime": "YYYY-MM-DDTHH:MM:SS.SSSZ",
"scheduledType": "Scheduled_Payment_Type",
"creditorReference": "Creditor_Reference",
"debtorReference": "Debtor_Reference",
"instructedAmount": {
"amount": "00.00",
"currency": "Currency"
},
"creditorAgent": {
"identificationType": "Creditor_Identification_Type",
"identification": "Creditor_Identification"
},
"creditorAccount": [
{
"identificationType": "Creditor_Account_Identification_Type",
"identification": "Creditor_Account_Identification"
}
]
},
{
"scheduledPaymentId": "Scheduled_Payment_Id",
"scheduledPaymentDateTime": "YYYY-MM-DDTHH:MM:SS.SSSZ",
"scheduledType": "Scheduled_Payment_Type",
"creditorReference": "Creditor_Reference",
"debtorReference": "Debtor_Reference",
"instructedAmount": {
"amount": "00.00",
"currency": "Currency"
},
"creditorAgent": {
"identificationType": "Creditor_Identification_Type",
"identification": "Creditor_Identification"
},
"creditorAccount": [
{
"identificationType": "Creditor_Account_Identification_Type",
"identification": "Creditor_Account_Identification"
}
]
},
{
"scheduledPaymentId": "Scheduled_Payment_Id",
"scheduledPaymentDateTime": "YYYY-MM-DDTHH:MM:SS.SSSZ",
"scheduledType": "Scheduled_Payment_Type",
"creditorReference": "Creditor_Reference",
"debtorReference": "Debtor_Reference",
"instructedAmount": {
"amount": "00.00",
"currency": "Currency"
},
"creditorAgent": {
"identificationType": "Creditor_Identification_Type",
"identification": "Creditor_Identification"
},
"creditorAccount": [
{
"identificationType": "Creditor_Account_Identification_Type",
"identification": "Creditor_Account_Identification"
}
]
}
]
},
"links": {
"self": "https://"
},
"meta": {
"totalPages": 0
}
}
]
}
Response description
JSON Tag | Description |
---|---|
success | Process success status represented as True or False |
payload | Payload tag carrying response information |
code | Unique bank code identification |
data | Tag carrying account and Scheduled Payments data included in the response |
accountId | Unique account identification |
scheduledPayment | Tag carrying information on Scheduled Payments of the account |
scheduledPaymentId | Unique Scheduled Payment identification |
scheduledPaymentDateTime | Date and time of the Scheduled Payment |
scheduledPaymentType | Type of the Scheduled Payment |
creditorReference | Unique creditor reference details |
debtorReference | Unique debtor reference details |
instructedAmount | Tag carrying information on the Scheduled Payment instructed amount |
amount | Transaction amount of the Scheduled Payment |
currency | Default currency in which the Scheduled Payment amount is indicated |
creditorAgent | Tag carrying information about creditor agent |
identificationType | Type of identification of the creditor |
identification | Unique creditor identification details |
creditorAccount | Tag carrying information about creditor account |
identificationType | Type of identification of the creditor account |
identification | Unique creditor account identification details |
links | Redirect link |
self | Own link/URL details |
meta | Meta tag |
totalPages | Information displayed in terms of pages |
Updated 6 months ago