---
title: "Retrieve Pre-Debit Notification by Merchant Reference"
method: GET
path: "/predebit-notify"
---

# Retrieve Pre-Debit Notification by Merchant Reference

`GET /predebit-notify`

Retrieves a pre-debit notification by the merchant reference used to create it.

## Query parameters

- `merchant_reference` string, required

## Headers

- `X-account-code` string, uuid, required

## Response `200`

The pre-debit notification.

- object
  - `id` string, uuid — Unique identifier of the pre-debit notification. Reference it on the recurring debit as payment_method.detail.bank_transfer.pre_debit_notification_id.
  - `account_id` string, uuid — Your Yuno account ID.
  - `status` 'SENT' | 'REJECTED' | 'ERROR' — SENT: the provider accepted and delivered the notification. REJECTED: the provider refused it. ERROR: the notification could not be relayed.
  - `merchant_reference` string — Your unique reference for this notification (idempotent per account).
  - `description` string — Text shown to the customer in the notification.
  - `amount` object
    - `currency` string, required — ISO 4217 currency code of the upcoming debit (for UPI Autopay, INR).
    - `value` string, required — Amount of the upcoming debit.
  - `billing_date` string, date — Date of the upcoming debit (YYYY-MM-DD).
  - `origin_payment_id` string, uuid — The mandate-creation payment used to derive provider and connection, when provided.
  - `provider_data` object
    - `id` string — Provider that handled the notification (for example, EBANX).
    - `connection_id` string, uuid — Connection used to send the notification.
    - `provider_transaction_id` string — Provider transaction reference, when available.
    - `provider_notification_id` string — Provider reference of the delivered notification. Yuno resolves and forwards it to the provider automatically when the recurring debit references this notification.
    - `raw_request` object — Obfuscated provider request. Only returned for allowlisted organizations.
    - `raw_response` object — Obfuscated provider response. Only returned for allowlisted organizations.
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404` — No notification with this merchant reference exists for your account.

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)