---
title: "Funds Transfer"
method: POST
path: "/lending-service/api/v1/payments/transfer"
---

# Funds Transfer

`POST /lending-service/api/v1/payments/transfer`

## Request

- Base URL: `https://sandbox.interswitchng.com`
- URL: `https://sandbox.interswitchng.com/lending-service/api/v1/payments/transfer`
- Auth: none required

This endpoint is provisioned for providers to use when they want to credit the user’s account for a specified amount.

## Headers

- `Authorization` string

## Request body

- object
  - `customerId` string, required: The Email or Mobile Number of the User to the credited. Max length: 50
  - `amount` integer, required: The Amount to be credited to the user’s account (in minor).
  - `currencyCode` string: ISO 4217 standard currency code. Default to 566. Max length: 3
  - `accountNumber` string, required: The NUBAN Account Number of the Beneficiary
  - `accountType` string, required: The Account Type of the Beneficiary Account. E.g 10
  - `bankCode` string, required: The CBN Bank Code of the bank holding the Beneficiary account. E.g 058. Max length: 5
  - `transactionId` string, required: The Client Transaction ID. This is the reference that the client will use to re-query for the transaction status in case of an unresolved state.
  - `qtTerminalId` string: The quickteller terminal Id to be used for the transaction
  - `loanId` string: The loanId for a loan taking through Lending Service
  - `loanReferenceId` string: A unique identifier assigned to the loan taken through Lending Service. It should be the same loan reference id that was sent to the provider in the AcceptOffer request body
  - `providerCode` string

## Response `200`

200

- object
  - `responseCode` string
  - `responseMessage` string
  - `transactionRef` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/interswitchgroup/apis/ipg.md) - [All operations](https://skmtc.dev/interswitchgroup/apis/ipg/llms.txt) - [OpenAPI document](https://skmtc.dev/interswitchgroup/apis/ipg/revisions/98dead048190?raw)