Operation get_batch_info
The operation of getting detailed information about the downloaded batch payment document.
Query parameters
Parameter | Value |
---|---|
operation | get_batch_info |
login | <Username> |
token | <TOKEN>. Obtained after invoking get_token. |
encrypted_password | Encrypted password. It is obtained after user password RSA encryption with the use of a public exponent and the modulus obtained in invoking the get_token operation. |
batch_id | <payment id>. Payment document identifier obtained by invoking import_batch_advanced. |
page_size | The number of records to get. |
start_offset | The number of the record that starts the resulting set. Minimum – 0, maximum is the number of records in the batch payment document. You can use page parameter instead — Page number (counts from 0). |
See also
- import_batch_advanced — Uploading a batch payment into the system with the possibility to choose the verification method.
- process_batch — Batch payment confirmation.
Response
Values
Value | Description |
---|---|
<payment ID> | The ID of the batch payment document created in the system. |
<offset> | The number of the first record in the generated result set (starting with 0) |
<page_size> | The number of records to get |
<total_size> | The total number of records in the batch |
<page_count> | Total number of pages |
<current_page> | Current page number (counts from 0) |
<document status> | It may take the following values:
|
<payment type> | It may take the SKIP value if the document was rejected at the stage of uploading (import_batch_advanced) a batch payment (see details in <error description>) |
<error description> | Description of the reason for rejecting the document |
Response examples
JSON (recommended format, please set x-response-format=json header)
{
"code": 0,
"message": "",
"data": {
"id": "c1f56606-15a8-43ff-99ef-a2a63ddc819a",
"offset": 0,
"page": 0,
"pageSize": 100,
"pageCount": 1,
"totalCount": 9,
"records": [
{
"lineNumber": 1,
"internalNumber": "1003",
"beneficiary": "Z112224443331",
"amount": "1.10",
"currency": "USD",
"description": "Payout 3",
"documentId": 92362495,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 2,
"internalNumber": "1004",
"beneficiary": "Z112224443331",
"amount": "1.20",
"currency": "USD",
"description": "Payout 4",
"documentId": 92362517,
"state": "DECLINED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 3,
"internalNumber": "1005",
"beneficiary": "Z112224443331",
"amount": "1.30",
"currency": "USD",
"description": "Payout 5",
"documentId": 92362539,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 4,
"internalNumber": "1006",
"beneficiary": "Z112224443331",
"amount": "1.40",
"currency": "USD",
"description": "Payout 6",
"documentId": 92362561,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 5,
"internalNumber": "1007",
"beneficiary": "Z112224443331",
"amount": "1.50",
"currency": "USD",
"description": "Payout 7",
"documentId": 92362583,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 6,
"internalNumber": "1008",
"beneficiary": "R555511198765",
"amount": "1.10",
"currency": "RUR",
"description": "Payout 8",
"documentId": 92362605,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
},
{
"lineNumber": 7,
"internalNumber": "1009",
"beneficiary": "R555511198765",
"amount": "1.20",
"currency": "RUR",
"description": "Payout 9",
"documentId": 92362627,
"state": "PROCESSED",
"paymentType": "WM",
"errorDetails": "",
"txId": null
}
]
}
}