Fund Customer Wallet by Payment Token

This endpoint allows a customer to fund their wallet account either via a payment token or directly from the wallet. Supported payment flows include:

Using an online card payment token from a supported payment gateway
Funding via the customer wallet if no token is provided

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

enum

required

Type of payable item.

string

required

Unique ID of the payable item to fund.

string

required

Payment gateway token reference when using card payment.

enum

required

Payment gateway provider. Options:

STRIPE_ACH
COINBASE_PAYMENT_API
POLI_PAYMENT_API
SECURE_TRADING
RAVE_FLUTTERWAVE
CUSTOM_POINT_OF_SALE

enum

required

Method of payment. Options include:

ONLINE_CARD_PAYMENT
E_WALLET

number

required

Total amount to process for checkout.

string

Optional beneficiary phone number for payment processing.

string

Optional password required for certain wallet payments.

string

Optional account number for wallet or bank account payment.

enum

Currency code for the payment account, if applicable.

Code Examples

curl --request POST \
  --url "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/processpaymentwithpaymenttoken" \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: your_auth_token' \
  --header 'uuid: your_device_uuid' \
  --header 'platform: WEB' \
  --data '{
    "payableType": "TRANSACTION",
    "payAbleId": "PAY12345",
    "paymentGatewayRef": "TOKEN_98765",
    "supportedPaymentGateWayProvider": "RAVE_FLUTTERWAVE",
    "paymentMethod": "ONLINE_CARD_PAYMENT",
    "totalCheckOutAmount": 150.00,
    "accountNumber": "1234567890",
    "paymentAccountNumbeCurrencyCode": "USD"
  }'

const response = await fetch(
  "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/processpaymentwithpaymenttoken",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Auth-Token": authToken,
      "uuid": deviceUuid,
      "platform": "WEB"
    },
    body: JSON.stringify({
      payableType: "TRANSACTION",
      payAbleId: "PAY12345",
      paymentGatewayRef: "TOKEN_98765",
      supportedPaymentGateWayProvider: "RAVE_FLUTTERWAVE",
      paymentMethod: "ONLINE_CARD_PAYMENT",
      totalCheckOutAmount: 150.00,
      accountNumber: "1234567890",
      paymentAccountNumbeCurrencyCode: "USD"
    })
  }
);

const data = await response.json();

import requests

url = "https://{your-domain}.fincode.software/api/v6/services/paymentmanagement/processpaymentwithpaymenttoken"
headers = {
    "Content-Type": "application/json",
    "X-Auth-Token": "your_auth_token",
    "uuid": "your_device_uuid",
    "platform": "WEB"
}
payload = {
    "payableType": "TRANSACTION",
    "payAbleId": "PAY12345",
    "paymentGatewayRef": "TOKEN_98765",
    "supportedPaymentGateWayProvider": "RAVE_FLUTTERWAVE",
    "paymentMethod": "ONLINE_CARD_PAYMENT",
    "totalCheckOutAmount": 150.00,
    "accountNumber": "1234567890",
    "paymentAccountNumbeCurrencyCode": "USD"
}

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

Getting Started

Core Flows

API Endpoints

Fund Customer Wallet by Payment Token

Authentication

Request Body

Code Examples

​Authentication

​Request Body

​Code Examples

Authentication

Request Body

Code Examples