Skip to main content
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

​
X-Auth-Token
string
required
Authentication token obtained after login.
​
uuid
string
required
Device UUID used for request tracking.
​
platform
string
required
Platform identifier (e.g., “WEB”, “ANDROID”, “IOS”).

​
Request Body

​
awaitingPaymentId
string
required
Unique ID of the awaiting payment to update.
​
subAction
string
required
Action to perform. Accepted values:
  • "paid"
  • "cancel"
​
selectedCurrency
string
Currency used to filter updated list results (e.g., "USD", "NGN").
​
fromDate
string
Start date (dd/MM/yyyy) for fetching updated awaiting payments.
​
toDate
string
End date (dd/MM/yyyy) for fetching updated awaiting payments.

​
Code Examples

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