Awaiting Payment Actions

This endpoint allows a user (excluding cashiers) to perform actions on an existing awaiting bank transfer payment. Supported actions include:

Marking a payment as paid
Marking a payment as cancelled
Returning an updated list of awaiting payments using optional date and currency filters

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

Unique ID of the awaiting payment to update.

string

required

Action to perform. Accepted values:

"paid"
"cancel"

string

Currency used to filter updated list results (e.g., "USD", "NGN").

string

Start date (dd/MM/yyyy) for fetching updated awaiting payments.

string

End date (dd/MM/yyyy) for fetching updated awaiting payments.

Code Examples

curl --request POST \
  --url "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/awaiting-payment-actions" \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: your_auth_token' \
  --header 'uuid: your_device_uuid' \
  --header 'platform: WEB' \
  --data '{
    "awaitingPaymentId": "AP12345",
    "subAction": "paid",
    "selectedCurrency": "USD",
    "fromDate": "01/01/2024",
    "toDate": "31/01/2024"
  }'

const response = await fetch(
  "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/awaiting-payment-actions",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Auth-Token": authToken,
      "uuid": deviceUuid,
      "platform": "WEB"
    },
    body: JSON.stringify({
      awaitingPaymentId: "AP12345",
      subAction: "paid",
      selectedCurrency: "USD",
      fromDate: "01/01/2024",
      toDate: "31/01/2024"
    })
  }
);

const data = await response.json();

import requests

url = "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/awaiting-payment-actions"
headers = {
    "Content-Type": "application/json",
    "X-Auth-Token": "your_auth_token",
    "uuid": "your_device_uuid",
    "platform": "WEB"
}

payload = {
    "awaitingPaymentId": "AP12345",
    "subAction": "paid",
    "selectedCurrency": "USD",
    "fromDate": "01/01/2024",
    "toDate": "31/01/2024"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

Getting Started

Core Flows

API Endpoints

Authentication

Request Body

Code Examples

​Authentication

​Request Body

​Code Examples

Authentication

Request Body

Code Examples