Server to Server Management APIs
Receipt

Receipt

Get receipts

GET /receipts

Request

Get receipts, with pagination data

Authentication

  • authToken in header

Parameters

  • offset in query - integer
    Pagination offset default: 0
  • limit in query with default of 10 - integer
    Pagination limit default: 10
  • orderBy in query with default of DESC - string
    Allow: 'DESC', 'ASC'

    Allowed: DESC | ASC

  • sortBy in query with default of createdAt - string
    The response sorted by which field

    Allowed: customerId | externalCustomerId | paymentId | total | transactionType | referenceNumber | createdAt | updatedAt

  • q in query - string
    You can perform keyword queries on fields corresponding to the value of "searchBy" or, if "searchBy" is empty, on all fields supported by "searchBy".
  • searchBy in query - string
    The response search by which field

    Allowed: payerName | referenceNumber | customerId | externalId | externalCustomerId

  • paymentStatus[] in query - array
    Payment processing status. 0 means ‘Incomplete’ status, 1 means ‘Awaiting Processing’ status, 2 means ‘Processing’ status, 3 means ‘Completed’ status, 4 means ‘Refunded' status
    Type: array[number]

    Allowed: 0 | 1 | 2 | 3 | 4

example

Response

OK

Body

object | application/json
  • code
    number
    required

  • data
    array[object]
    required

  • meta
    object
    required

example-1

Get a receipt

GET /receipts/{receiptId}

Request

Get a receipt detail

Authentication

  • authToken in header

Parameters

  • receiptId in path - string
    required
    The unique ID of the receipt.

example

Response

OK

Body

object | application/json
  • code
    number
    required

  • data
    object
    required

  • meta
    object
    required

example-1

Delete a receipt

DELETE /receipts/{receiptId}

Request

Delete a receipt

Authentication

  • authToken in header

Parameters

  • receiptId in path - string
    required
    The unique ID of the receipt.

example

Response

OK

Body

object | application/json
  • code
    number

    Response code of a successful request.
  • data
    object

  • meta
    object

example-1

Get all receipt lines

GET /receipt-lines

Request

Get all receipt lines, with pagination data

Authentication

  • authToken in header

Parameters

  • offset in query - integer
    Pagination offset default: 0
  • limit in query with default of 10 - integer
    Pagination limit default: 10
  • orderBy in query with default of DESC - string
    Allow: 'DESC', 'ASC'

    Allowed: DESC | ASC

  • paymentStatus[] in query - array
    Payment processing status. 0 means ‘Incomplete’ status, 1 means ‘Awaiting Processing’ status, 2 means ‘Processing’ status, 3 means ‘Completed’ status, 4 means ‘Refunded' status
    Type: array[number]

    Allowed: 0 | 1 | 2 | 3 | 4

  • q in query - string
    You can perform keyword queries on fields corresponding to the value of "searchBy" or, if "searchBy" is empty, on all fields supported by "searchBy".
  • searchBy in query - string
    The response search by which field

    Allowed: customerId | externalId | externalCustomerId | payerName | payerCustomerId | referenceNumber | invoiceId

  • sortBy in query with default of createdAt - string
    The response sorted by which field

    Allowed: customerId | externalCustomerId | receiptId | invoiceId | amount | createdAt | updatedAt

example

Response

OK

Body

object | application/json
  • code
    number
    required

  • data
    array[object]
    required

  • meta
    object
    required

example-1

Get lines of a receipt

GET /receipts/{receiptId}/lines

Request

Get lines of a receipt, with pagination data

Authentication

  • authToken in header

Parameters

  • receiptId in path - string
    required
    The unique ID of the receipt.
  • offset in query - integer
    Pagination offset default: 0
  • limit in query with default of 10 - integer
    Pagination limit default: 10
  • orderBy in query with default of DESC - string
    Allow: 'DESC', 'ASC'

    Allowed: DESC | ASC

  • paymentStatus[] in query - array
    Payment processing status. 0 means ‘Incomplete’ status, 1 means ‘Awaiting Processing’ status, 2 means ‘Processing’ status, 3 means ‘Completed’ status, 4 means ‘Refunded' status
    Type: array[number]

    Allowed: 0 | 1 | 2 | 3 | 4

  • q in query - string
    You can perform keyword queries on fields corresponding to the value of "searchBy" or, if "searchBy" is empty, on all fields supported by "searchBy".
  • searchBy in query - string
    The response search by which field

    Allowed: customerId | externalId | externalCustomerId | payerName | payerCustomerId | referenceNumber | invoiceId

  • sortBy in query with default of createdAt - string
    The response sorted by which field

    Allowed: customerId | externalCustomerId | receiptId | invoiceId | amount | createdAt | updatedAt

example

Response

OK

Body

object | application/json
  • code
    number
    required

  • data
    array[object]
    required

  • meta
    object
    required

example-1

Get a receipt line detail

GET /receipts/{receiptId}/lines/{receiptLineId}

Request

Get a receipt line detail

Authentication

  • authToken in header

Parameters

  • receiptId in path - string
    required
    The unique ID of the receipt.
  • receiptLineId in path - string
    required
    The unique ID of the receipt line.

example

Response

OK

Body

object | application/json
  • code
    number
    required

  • data
    object
    required

  • meta
    object
    required

example-1

Delete a receipt line

DELETE /receipts/{receiptId}/lines/{receiptLineId}

Request

Delete a receipt line

Authentication

  • authToken in header

Parameters

  • receiptId in path - string
    required
    The unique ID of the receipt.
  • receiptLineId in path - string
    required
    The unique ID of the receipt line.

example

Response

OK

Body

object | application/json
  • code
    number

    Response code of a successful request.
  • data
    object

  • meta
    object

example-1

Did you find what you were looking for?