Payment Enquiry
Get payment request details and status
Payment Enquiry API services allows you to know the payment information that has been processed. This allows you to track and get the payment status in real-time.
Get Payment Enquiry
Endpoint details
Endpoint URL | Method | Authentication requirements |
---|---|---|
/v1/api/erp/svPayEnquiryService/ | POST | 1. clientid 2. clientsecret 3. signature |
A request in the following format should be posted to the above-mentioned endpoint to fetch the payment status and details:
curl --location --request POST 'https://servicesuat.onesingleview.com/v1/api/erp/svPayEnquiryService' \
--header 'clientid: Enter_Client_ID' \
--header 'clientsecret: Enter_Client_Secret' \
--header 'signature: Enter_Signature' \
--header 'Content-Type: application/json' \
--data-raw '{
"svPayEnquiryServiceRQ": {
"company": [
{
"companyCode": "Enter_Company_Code",
"fromDate": "YYYY-MM-DDTHH:MM:SSZ",
"toDate": "YYYY-MM-DDTHH:MM:SSZ",
"payId": [
"Payment_ID","Payment_ID"
],
"authId": [
"Authentication_ID","Authentication_ID"
]
}
]
}
}'
Request details:
JSON Tag | Description | Data type |
---|---|---|
clientid Mandatory | Client ID | String |
clientsecret Mandatory | Client Code | String |
signature Mandatory | Signature | String |
svPayEnquiryServiceRQ Mandatory | Payment enquiry request tag | Object |
company Mandatory | Array of companies | Array |
companyCode Mandatory | Unique company code | String |
fromDate Mandatory | From Date Period | String |
toDate Mandatory | To Date Period | String |
payId Mandatory | Array of ERP pay IDs | Array |
authId Mandatory | Array of ERP Authentication IDs | Array |
If the details are found to be valid, the following successful response will be displayed:
{
"svPayEnquiryServiceRS": {
"company": [
{
"companyCode": "Company_Code",
"payment": [
{
"payId": "Payment_ID",
"authId": "Authentication_ID",
"seqNum": "Sequence_Number",
"svRefId": "SV_Reference_ID",
"amount": 00.00,
"currency": "Currency",
"txnDate": "YYYY-MM-DDTHH:MM:SSZ",
"approval_status":Approval_Status,
"bankCharges":"Y or N",
"chargeAmount":00.00,
"status": Status, // completed
"message": "Message"
},
{
"payId": "Payment_ID",
"authId": "Authentication_ID",
"seqNum": "Sequence_Number",
"svRefId": "SV_Reference_ID",
"amount": 00.00,
"currency": "Currency",
"txnDate": "YYYY-MM-DDTHH:MM:SSZ",
"approval_status":Approval_Status,
"bankCharges":"Y or N",
"chargeAmount":00.00,
"status": Status, // completed
"message": "Message"
}
]
}
]
}
}
Response description:
JSON Tag | Description | Data type |
---|---|---|
svPaymentServiceRS | Add payment services Response Tag | Object |
company | Array of companies | Array |
companyCode | Unique company code | String |
payment | Array of payments | Array |
authId | Singleview Authentication ID | String |
payId | Unique reference id toward payment request from ERP | String |
seqNum | Sequence number | String |
svRefId | Singleview Reference ID | String |
amount | Amount | String |
chargeAmount | Amount charged | String |
currency | Currency of payment | String |
txnDate | Transaction date | String |
approval_status | Approval status of the payment request | String |
bankCharges | Amount charged by the bank | String |
chargeAmount | Charged Amount | String |
status | Status of the payment | String |
message | Message of payment processing | String |
Note
Refer
Types & Statuses
for more info on payment status update codes.
Updated 4 months ago