curl --get "${BASE_URL}/api/v2/trans/bulk-upload/result" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  --data-urlencode merchant_id=48290713 \
  --data-urlencode file_identifier=PAY2030001

{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "09ef4182-bcd8-4bb1-a326-498a05f0e4bb",
    "batch": {
      "batch_id": 2048,
      "upload_request_id": "19eb4182-bcd8-4bb1-a326-498a05f0e4aa",
      "merchant_id": "7294815",
      "business_id": "48290713",
      "file_identifier": "PAY2030001",
      "status": "completed",
      "declared_detail_count": 2,
      "declared_total_amount_cents": 7350
    },
    "summary": {
      "validation_failed": 0,
      "queued": 0,
      "processing": 0,
      "created_pending": 1,
      "payment_succeeded": 1,
      "payment_failed": 0,
      "system_failed": 0
    },
    "details": [
      {
        "line_number": 1,
        "record_line_no": 2,
        "reference_number": "INV-2030-001",
        "account_type": "BC",
        "amount_cents": 2550,
        "status": "created_pending",
        "failure_reason": "",
        "trans_no": "b1893452400000826",
        "transaction_status": 3,
        "transaction_status_text": "Pending",
        "transaction_result": ""
      },
      {
        "line_number": 2,
        "record_line_no": 3,
        "reference_number": "INV-2030-002",
        "account_type": "CT",
        "amount_cents": 4800,
        "status": "payment_succeeded",
        "failure_reason": "",
        "trans_no": "b1893452400000972",
        "transaction_status": 1,
        "transaction_status_text": "Successful",
        "transaction_result": ""
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total": 2,
      "last_page": 1
    }
  }
}

Transactions

Query a TXT batch and its details

Retrieve a batch and its per-record processing results for the authenticated merchant, optionally filtered by business. Use an OAuth2 Bearer token; no request signature is required. Supply batch_id or file_identifier. When both are supplied, they must match the same batch.

line_number is the logical number in a D record; record_line_no is the physical file line number including the header. Results are paginated in ascending line_number order. line_number and status filters combine, and details is always an array. Use page 1 for a single-line lookup. pagination.total counts filtered records, while summary always covers all current details in the batch.

code=0 only means the lookup succeeded, even when the batch or details failed. Batch completed means transaction creation processing is complete; it does not guarantee payment success. Read both detail status and transaction_status. created_pending may also correspond to an expired transaction. details=[] can mean details are not yet available or no records match; it does not mean all payments succeeded. Transaction numbers and statuses may be null when unavailable; do not repeat payments on that basis.

Use OAuth credentials for the same merchant. merchant_id may be omitted or empty to locate the batch across all businesses of that merchant; when supplied, it must match the business identifier in the original upload. This lookup only returns processing results and does not execute payments again.

GET

api

trans

bulk-upload

result

curl --get "${BASE_URL}/api/v2/trans/bulk-upload/result" \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H "Accept: application/json" \
  --data-urlencode merchant_id=48290713 \
  --data-urlencode file_identifier=PAY2030001

{
  "code": 0,
  "message": "ok",
  "data": {
    "request_id": "09ef4182-bcd8-4bb1-a326-498a05f0e4bb",
    "batch": {
      "batch_id": 2048,
      "upload_request_id": "19eb4182-bcd8-4bb1-a326-498a05f0e4aa",
      "merchant_id": "7294815",
      "business_id": "48290713",
      "file_identifier": "PAY2030001",
      "status": "completed",
      "declared_detail_count": 2,
      "declared_total_amount_cents": 7350
    },
    "summary": {
      "validation_failed": 0,
      "queued": 0,
      "processing": 0,
      "created_pending": 1,
      "payment_succeeded": 1,
      "payment_failed": 0,
      "system_failed": 0
    },
    "details": [
      {
        "line_number": 1,
        "record_line_no": 2,
        "reference_number": "INV-2030-001",
        "account_type": "BC",
        "amount_cents": 2550,
        "status": "created_pending",
        "failure_reason": "",
        "trans_no": "b1893452400000826",
        "transaction_status": 3,
        "transaction_status_text": "Pending",
        "transaction_result": ""
      },
      {
        "line_number": 2,
        "record_line_no": 3,
        "reference_number": "INV-2030-002",
        "account_type": "CT",
        "amount_cents": 4800,
        "status": "payment_succeeded",
        "failure_reason": "",
        "trans_no": "b1893452400000972",
        "transaction_status": 1,
        "transaction_status_text": "Successful",
        "transaction_result": ""
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 50,
      "total": 2,
      "last_page": 1
    }
  }
}

Authorizations

Authorization

string

header

required

OAuth2 client_credentials authorization. Obtain a new access_token when it expires.

Query Parameters

merchant_id

string | null

Optional business identifier, up to 20 characters. When supplied, it must belong to the authenticated merchant and match the target batch. Omit it or leave it empty to locate a batch across all businesses of that merchant.

Maximum string length: 20

batch_id

integer<int64> | null

Supply this or file_identifier; both must match the same batch when supplied together.

Required range: x >= 1

file_identifier

string | null

Supply this or batch_id; both must match the same batch when supplied together.

Required string length: 10

Pattern: ^[A-Za-z0-9_]{10}$

line_number

integer | null

Filter by exact logical line number, minimum 1. Combines with status when both are supplied; details remains an array.

Required range: x >= 1

page

integer | null

default:1

Page number, starting at 1; defaults to 1 when omitted or null.

Required range: x >= 1

page_size

integer | null

default:50

Records per page, range 1–200; defaults to 50 when omitted or null.

Required range: 1 <= x <= 200

status

enum<string> | null

Filter by one detail status. validation_failed: Detail validation failed; payment processing was not started; queued: Awaiting processing; processing: Processing; created_pending: Transaction created without a confirmed success or failure; the transaction may also have expired; payment_succeeded: Payment succeeded; payment_failed: Payment failed; system_failed: Processing error; verify the payment outcome.

Available options:

validation_failed,

queued,

processing,

created_pending,

payment_succeeded,

payment_failed,

system_failed,

null

Response

HTTP 200. code=0 means the lookup succeeded; code=1 indicates a business or authentication error; code=400 indicates invalid query parameters.

Option 1
Option 2

code

enum<integer>

required

Lookup succeeded; code is still 0 when the batch or individual details have failed.

Available options:

0

message

string

required

Result message; ok on success.

Example:

"ok"

data

object

required

Response data.

Show child attributes

Transactions

Subscriptions

Authentication

Query a TXT batch and its details

Authorizations

Query Parameters

Response