> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincode.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Notify Bank Transfer Payment

> Notify the system that a customer has made a bank transfer payment, alerting Admin to verify or take appropriate action.

This endpoint allows a customer to **notify the system** about a bank transfer payment.

Supported options include:

* `bank_pay_later` – Customer will pay later; adds item to awaiting payments list
* `bank_paid_now` – Customer confirms payment has been made
* `mistake` – Customer reports a payment was made by mistake

## Authentication

<ParamField header="X-Auth-Token" type="string" required>
  Authentication token obtained after login.
</ParamField>

<ParamField header="uuid" type="string" required>
  Device UUID used for request tracking.
</ParamField>

<ParamField header="platform" type="string" required>
  Platform identifier (e.g., "WEB", "ANDROID", "IOS").
</ParamField>

***

## Request Body

<ParamField body="pcn" type="string" required>
  Payment code number associated with the transaction or transfer.
</ParamField>

<ParamField body="option" type="enum" required>
  Action the customer is notifying. Options:

  * `bank_pay_later`
  * `bank_paid_now`
  * `mistake`
</ParamField>

<ParamField body="payAbleType" type="string">
  Type of payable item. Defaults to `TRANSACTION` if not specified.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/notify-bank-transfer-payment" \
    --header 'Content-Type: application/json' \
    --header 'X-Auth-Token: your_auth_token' \
    --header 'uuid: your_device_uuid' \
    --header 'platform: WEB' \
    --data '{
      "pcn": "PCN12345",
      "option": "bank_paid_now",
      "payAbleType": "TRANSACTION"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/notify-bank-transfer-payment",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-Auth-Token": authToken,
        "uuid": deviceUuid,
        "platform": "WEB"
      },
      body: JSON.stringify({
        pcn: "PCN12345",
        option: "bank_paid_now",
        payAbleType: "TRANSACTION"
      })
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  url = "https://remitjunction.fincode.software/api/v6/services/paymentmanagement/notify-bank-transfer-payment"
  headers = {
      "Content-Type": "application/json",
      "X-Auth-Token": "your_auth_token",
      "uuid": "your_device_uuid",
      "platform": "WEB"
  }
  payload = {
      "pcn": "PCN12345",
      "option": "bank_paid_now",
      "payAbleType": "TRANSACTION"
  }

  response = requests.post(url, json=payload, headers=headers)
  data = response.json()
  ```
</CodeGroup>

## Use Cases

### 1. Notify That Payment Has Been Made Now

```javascript theme={null}
await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "bank_paid_now"
});
```

***

### 2. Notify That Payment Will Be Paid Later

```javascript theme={null}
await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "bank_pay_later"
});
```

***

### 3. Notify a Payment Was Made by Mistake

```javascript theme={null}
await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "mistake"
});
```