Refund

List all Refunds

Changed on

Retrieve a list of all the refunds. Use query parameters to filter the list.

This API comes with Pagination support, you can customize limit and page query parameters as per the requirements.

get/refund

Request

  • Base URL
    https://api.finmo.net/v1
  • Auth
    HTTP basic

Query parameters

status'PENDING' | 'COMPLETED' | 'FAILED'
Example:PENDING

List refunds by their status (PENDING, COMPLETED & FAILED)

payin_idstring
Example:payin_3b48f7a5bfc84f00835f6bb6ced2ee73

List all refunds with the original Payin_id

amountnumber
Example:10

Max number of transactions per page. Default is 10 transactions per page

created_atstring date

YYYY-MM-DD (UTC date). If you wish to search based on local time then use start_time and end_time fields

start_timeinteger
Example:1000

EPOCH timestamp

end_timeinteger
Example:1231234123

EPOCH timestamp

limitinteger
Example:10

Max number of transactions per page. Default is 10 transactions per page

pageinteger
Example:1

The page number to return. If unspecified, the first page is returned

Response

OK

request_idstring
request_timestring date-time
status_codeinteger
status_textstring
successboolean

Example response

{
  "data": [
    {
      "amount": 10000,
      "created_at": "2022-09-27T06:19:57.624Z",
      "currency": "AUD",
      "customer_id": null,
      "debit_wallet_id": "wallet_68116e9dc8e34961a09f6cc1863c5f64",
      "debit_wallet_transaction_id": "w_txn_106a2cbf33cc4f16ba6a02cf1453714f",
      "description": null,
      "fees_currency": null,
      "fees_including_tax": null,
      "fees_wallet_id": "wallet_09faa6f366194748be978fee5a0fa8aa",
      "fees_wallet_transaction_id": null,
      "fees_without_tax": null,
      "is_fees_charged": false,
      "metadata": null,
      "org_id": "org_ee37f12ed6854c11b8107771ea171bfa",
      "organization_reference_id": "8ce5dc6bec2fb6db84a100d7d63c2244",
      "payin_id": "payin_34593b1a03614ede87fc655311726bd9",
      "payin_method_name": "au_bank_npp",
      "receipt_email": null,
      "refund_id": "refund_ff6fee71061a44b198ee0f739961e5bb",
      "refunded_at": null,
      "status": "PENDING",
      "tax_on_fees": null,
      "transaction_id": null,
      "type": "FULL",
      "updated_at": "2022-09-27T06:19:57.624Z",
      "webhook_url": null
    }
  ]
}

Changes