Transfer

P2P Transfer

Transfers funds from one user’s wallet to another user’s wallet.

Endpoint

POST {{baseUrl}}/issuing/api/:version/wallet/transfer

Description

This API enables peer-to-peer wallet transfers. The sender initiates a transfer to another registered user by providing the receiver’s email and transfer details such as amount and purpose of transfer.

Request Path Parameters

Parameter	Type	Required	Description
version	string	Yes	API version number

Request Headers

Parameter	Type	Required	Description
x-api-key	string	Yes	Shared X-API key
x-product-id	string	Yes	Shared ProductID
x-cardholder-id	string	Yes	Unique identifier of the cardholder
x-request-id	string	Yes	Idempotency key for request tracking
Content-Type	string	Yes	Must be `application/json`

Request Body Parameters

Parameter	Type	Required	Description
email	string	Yes	Email of the receiver
amount	integer	Yes	Amount to be transferred
description	string	Yes	Short description/purpose for the transfer

Request Example

cURL

curl --location --request POST \
--url '{{baseUrl}}/issuing/api/:version/wallet/transfer' \
--header 'x-api-key: {{Shared X-API key}}' \
--header 'x-product-id: {{Shared ProductID}}' \
--header 'x-cardholder-id: {{CardholderID}}' \
--header 'x-request-id: {{IdempotencyKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "email": "johnsmith11@yopmail.com",
  "amount": 5,
  "description": "testing P2P"
}'

Response Example

200: Success
400: Error

{
  "status": "success",
  "message": "Funds Transferred Successfully!",
  "code": 200,
  "data": [
    {
      "id": "fund-transfer-id"
    }
  ]
}

{
  "code": 400,
  "message": "Error Message",
  "status": "error"
}

P2P Transfer​