Get a transfer's receipt

curl --request GET \
  --url https://api.panoflow.io/v1/transfers/{transfer_id}/receipt \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/transfers/{transfer_id}/receipt', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "receipt",
  "transfer_id": "trf_01JCM9S346Q3D25VT4F5V37E3S",
  "transaction_id": "txn_01JCS1A0ZWSK9TPRM7N0MNS7C0",
  "amount": {
    "amount": 48000000,
    "currency": "NGN"
  },
  "fee": {
    "amount": 5375,
    "currency": "NGN"
  },
  "status": "completed",
  "status_label": "Settled",
  "date": "2026-10-26T14:42:00Z",
  "narration": "PO-2291 haulage, October",
  "sent_by": "Adaeze Okafor",
  "paid_by": {
    "name": "Adaeze Logistics Ltd",
    "detail": "Naira · Main · ••••6789"
  },
  "paid_to": {
    "name": "Kano Freight Services",
    "detail": "••••4471 · GTBank"
  },
  "nip_session_id": "000023261026144212839104726351",
  "verification_url": "https://panoflow.io/verify?ref=txn_01JCS1A0ZWSK9TPRM7N0MNS7C0",
  "pdf_url": "https://files.panoflow.io/receipts/trf_01JCM9S346Q3D25VT4F5V37E3S.pdf?sig=3f9c1e",
  "pdf_expires_at": "2026-10-28T08:35:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

GET

transfers

{transfer_id}

receipt

Get a transfer's receipt

curl --request GET \
  --url https://api.panoflow.io/v1/transfers/{transfer_id}/receipt \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/transfers/{transfer_id}/receipt', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "receipt",
  "transfer_id": "trf_01JCM9S346Q3D25VT4F5V37E3S",
  "transaction_id": "txn_01JCS1A0ZWSK9TPRM7N0MNS7C0",
  "amount": {
    "amount": 48000000,
    "currency": "NGN"
  },
  "fee": {
    "amount": 5375,
    "currency": "NGN"
  },
  "status": "completed",
  "status_label": "Settled",
  "date": "2026-10-26T14:42:00Z",
  "narration": "PO-2291 haulage, October",
  "sent_by": "Adaeze Okafor",
  "paid_by": {
    "name": "Adaeze Logistics Ltd",
    "detail": "Naira · Main · ••••6789"
  },
  "paid_to": {
    "name": "Kano Freight Services",
    "detail": "••••4471 · GTBank"
  },
  "nip_session_id": "000023261026144212839104726351",
  "verification_url": "https://panoflow.io/verify?ref=txn_01JCS1A0ZWSK9TPRM7N0MNS7C0",
  "pdf_url": "https://files.panoflow.io/receipts/trf_01JCM9S346Q3D25VT4F5V37E3S.pdf?sig=3f9c1e",
  "pdf_expires_at": "2026-10-28T08:35:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Path Parameters

transfer_id

string

required

trf_…

Pattern: ^trf_[0-9A-HJKMNP-TV-Z]{26}$

Response

The receipt.

Data for the PayReceipt screen, for a transfer or a batch.

object

string

required

Always receipt.

Allowed value: "receipt"

amount

object

required

An amount in minor units (kobo, cents) with its currency. Never a decimal.

Show child attributes

status

enum<string>

required

Lifecycle shared by every money-moving resource (CONVENTIONS §8). UI labels: completed → "Settled", pending_approval → "Pending approval".

Available options:

draft,

pending_approval,

scheduled,

processing,

completed,

failed,

rejected,

canceled,

reversed

status_label

enum<string>

required

The pill text for status.

Available options:

Settled,

Processing,

Failed,

Scheduled,

Pending approval,

Rejected,

Canceled,

Reversed

date

string<date-time>

required

Completion time, or creation time if not completed.

Example:

"2026-10-27T08:41:00Z"

sent_by

string

required

Name of the person or agent who created it.

paid_by

object

required

Show child attributes

paid_to

object

required

Show child attributes

verification_url

string<uri>

required

Where anyone can check the receipt with its transaction id.

pdf_url

string<uri>

required

Signed link to the PDF, valid 5 minutes.

pdf_expires_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

transfer_id

string

trf_… for a transfer receipt.

batch_id

string

bat_… for a batch receipt.

transaction_id

string

txn_… shown as "Transaction ID" and used to check the receipt.

fee

object

An amount in minor units (kobo, cents) with its currency. Never a decimal.

Show child attributes

narration

string

Narration, or the file name for a batch.

nip_session_id

string

NIP session id, for payouts that were sent.

Pattern: ^\d{30}$

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Get a transfer's receipt

Authorizations

Headers

Path Parameters

Response