Notify Bank Transfer Payment

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

string

required

Authentication token obtained after login.

string

required

Device UUID used for request tracking.

string

required

Platform identifier (e.g., “WEB”, “ANDROID”, “IOS”).

Request Body

string

required

Payment code number associated with the transaction or transfer.

enum

required

Action the customer is notifying. Options:

bank_pay_later
bank_paid_now
mistake

string

Type of payable item. Defaults to TRANSACTION if not specified.

Code Examples

curl --request POST \
  --url "https://{your-domain}.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"
  }'

const response = await fetch(
  "https://{your-domain}.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();

import requests

url = "https://{your-domain}.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()

Use Cases

1. Notify That Payment Has Been Made Now

await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "bank_paid_now"
});

2. Notify That Payment Will Be Paid Later

await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "bank_pay_later"
});

3. Notify a Payment Was Made by Mistake

await notifyBankTransferPayment({
  pcn: "PCN12345",
  option: "mistake"
});

Getting Started

Core Flows

API Endpoints

Authentication

Request Body

Code Examples

Use Cases

1. Notify That Payment Has Been Made Now

2. Notify That Payment Will Be Paid Later

3. Notify a Payment Was Made by Mistake

​Authentication

​Request Body

​Code Examples

​Use Cases

​1. Notify That Payment Has Been Made Now

​2. Notify That Payment Will Be Paid Later

​3. Notify a Payment Was Made by Mistake

Authentication

Request Body

Code Examples

Use Cases

1. Notify That Payment Has Been Made Now

2. Notify That Payment Will Be Paid Later

3. Notify a Payment Was Made by Mistake