Bank Pay Later (Wallet)

This endpoint allows a user to mark a payment as ‘I will pay later’. It is typically used when a customer cannot pay immediately but wants the payment recorded in the Awaiting Payments List for follow-up. This API is used by dashboards, finance teams, or back-office operations to:

Record a payment intent without actual funds transfer
Generate an awaiting payment entry tied to the PCN and payable type
Allow subsequent operations to track or confirm the payment

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”).

Path Parameters

string

required

Payment code number (PCN) of the payable item. Minimum length: 3.

string

required

Payable type associated with the PCN. Minimum length: 5. Supported values correspond to the PayableType enum.

Code Examples

curl --request PUT \
  --url "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/bank-iwillpaylater-wallet/PCN123/TRANSACTION" \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: your_auth_token' \
  --header 'uuid: your_device_uuid' \
  --header 'platform: WEB'

const response = await fetch(
  "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/bank-iwillpaylater-wallet/PCN123/TRANSACTION",
  {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      "X-Auth-Token": authToken,
      "uuid": deviceUuid,
      "platform": "WEB"
    }
  }
);

const data = await response.json();

import requests

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

response = requests.put(url, headers=headers)
data = response.json()

Use Cases

1. Mark a Payment as “I Will Pay Later”

await bankIWillPayLater("PCN123", "TRANSACTION");

2. Track Payments Awaiting Customer Action

const response = await bankIWillPayLater("PCN678", "BILL");
console.log(response.data.ref, response.data.payableItemId);

Getting Started

Core Flows

API Endpoints

Authentication

Path Parameters

Code Examples

Use Cases

1. Mark a Payment as “I Will Pay Later”

2. Track Payments Awaiting Customer Action

​Authentication

​Path Parameters

​Code Examples

​Use Cases

​1. Mark a Payment as “I Will Pay Later”

​2. Track Payments Awaiting Customer Action

Authentication

Path Parameters

Code Examples

Use Cases

1. Mark a Payment as “I Will Pay Later”

2. Track Payments Awaiting Customer Action