---
title: "list refunds"
method: GET
path: "/payto/refunds"
tags: ["Refunds (Beta)"]
---

# list refunds

`GET /payto/refunds`

## Query parameters

- `per_page` integer
- `starting_after` string
- `min_created_date` string, date
- `max_created_date` string, date
- `original_payment_uid` string

## Response `200`

successful

- object
  - `links` PaytoPaginationLinks
    - `next` string — URL for next page of results. Won't be present if there are no further pages.
  - `data` PaytoRefund[]
    - `uid` string, required — Supplied unique identifier for refund, maximum 64 characters containing only unreserved characters as defined in RFC3986. This identifier ensures refund uniqueness between integrator systems and Zepto.
    - `state` 'created' | 'processing' | 'processed' | 'failed', required — The current state of the refund
    - `original_payment_uid` string, required — The supplied UID related to the PayTo Payment to be refunded
    - `refund_payment` union, required
      - object
        - `type` 'float_bank_payment' | 'pay_to_payment', required — The type of payment that should be used to facilitate this refund
        - `float_bank_account_id` string, uuid, required — The ID of the float account that should be debited to facilitate this payment
        - `amount` integer, required — Amount in cents.
        - `description` string, nullable, required — **MUST start with the word `REFUND`.** Free-form text for the matching/reconciliation of a transaction. This can be shown on both parties' bank statements. ASCII-printable characters and unicode emojis are accepted.
      - object
        - `type` 'float_bank_payment' | 'pay_to_payment', required — The type of payment that should be used to facilitate this refund
        - `agreement_uid` string, required — The uid related to the mandate that should be used to facilitate this refund, maximum 64 characters containing only unreserved characters as defined in RFC3986.
        - `uid` string — Optional supplied unique identifier for payto payment that will be made to complete this refund, maximum 64 characters containing only unreserved characters as defined in RFC3986. This identifier ensures payment uniqueness between integrator systems and Zepto. If no uid is provided here, the payto payment that will be made to complete this refund will inherit the uid of this refund as supplied in the `uid` paramater in the top level request object.
        - `amount` integer, required — Amount in cents.
        - `description` string, nullable — Free-form text for the matching/reconciliation of a transaction. This can be shown on both parties' bank statements. ASCII-printable characters and unicode emojis are accepted.
    - `created_at` string, date-time, required
    - `metadata` PaytoMetadata, nullable — Use for your custom data. A place to store any miscellaneous information your system may need in regards to the record you are creating. This will be included in associated webhook payloads under the `resource_metadata` key. Nested values (i.e., objects and arrays) are not allowed. The maximum size of this parameter is 2kb.
    - `failure` PaytoRefundFailure, nullable, required — Details about the refund failure, when the state is 'failed'
      - `title` string, required — A short description of the failure
      - `detail` string, required — A longer description of the failure
      - `code` 'ZPPAY00' | 'ZPREF07' | 'AC02' | 'AC03' | 'AC05' | 'AC06' | 'AC07' | 'AC14' | 'AG01' | 'AG03' | 'AGNT' | 'AM01' | 'AM02' | 'AM03' | 'AM06' | 'AM12' | 'AM19' | 'BE06' | 'BE08' | 'BE22' | 'CH20' | 'CH21' | 'DT02' | 'ED06' | 'FF04' | 'FF08' | 'FF10' | 'FF11' | 'TD03' | 'AB01' | 'AB02' | 'ZPPAY24' | 'AB03' | 'AB04' | 'AB08' | 'AC13' | 'AC15' | 'AG07' | 'AM04' | 'AM09' | 'AM21' | 'BE05' | 'CURR' | 'CUST' | 'DT04' | 'ED05' | 'FRAD' | 'MD01' | 'MD02' | 'MD20' | 'MS02' | 'MS03' | 'NARR' | 'NAUT' | 'RR02' | 'RR03' | 'RR04' | 'RC05' | 'SL01' | 'SL11' | 'SL12' | 'SL13' | 'SL14' | 'TM01' | 'AVED' | 'BVSD' | 'MCGP' | 'NACT' | 'ZPUNP01' | 'ZPUNP02' | 'ZPUNP06' | 'ZPUNP07' | 'ZPUNP08' | 'UKNWN', required — A unique identifier for this specific type of failure
    - `links` object, required
      - `self` string, required — A URL to this refund
      - `original_payment` string, required — A URL to the associated original payment

## Other responses

- `422` — Unprocessable Entity

---

[API](https://skmtc.net/zeptopayments/apis/zepto-api.md) · [All operations](https://skmtc.net/zeptopayments/apis/zepto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zeptopayments/zepto-api/revisions/6353e9b9af6f/schema)