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

​
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

​
payableType
enum
required
Type of payable item.
​
payAbleId
string
required
Unique ID of the payable item to fund.
​
paymentGatewayRef
string
required
Payment gateway token reference when using card payment.
​
supportedPaymentGateWayProvider
enum
required
Payment gateway provider. Options:
  • STRIPE_ACH
  • COINBASE_PAYMENT_API
  • POLI_PAYMENT_API
  • SECURE_TRADING
  • RAVE_FLUTTERWAVE
  • CUSTOM_POINT_OF_SALE
​
paymentMethod
enum
required
Method of payment. Options include:
  • ONLINE_CARD_PAYMENT
  • E_WALLET
​
totalCheckOutAmount
number
required
Total amount to process for checkout.
​
beneficiaryLookUpPhoneNumber
string
Optional beneficiary phone number for payment processing.
​
passWord
string
Optional password required for certain wallet payments.
​
accountNumber
string
Optional account number for wallet or bank account payment.
​
paymentAccountNumbeCurrencyCode
enum
Currency code for the payment account, if applicable.

​
Code Examples

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