P2P Transfer

Get Transfer Data

get
​

β€Žhttps://<domain>/<api prefix>/<version>/user/p2p/transfer/
This API endpoint will return p2p transfer charges and user data.
Request
Response
Request
Headers
apikey
required
string
Apikey
Authorization
required
string
Bearer access token
Query Parameters
wallet
optional
string
wallet key, default is wallet1
reciever
required
string
username
Response
200: OK
​HTTP/1.1 200 OK
Content-Type: application/json
​
Body:
{
"status_code": 200,
"errors": {},
"data": {
"wallet_data": {
"wallet_balance": <wallet_balance>,
"transfer_charges": {
"transfer_charge": "<transfer_charge>",
"max_transfer_amount": "<max_transfer_amount>",
"min_transfer_amount": "<min_transfer_amount>",
"transfer_charge_type": "<transfer_charge_type>"
},
"currency_data": {
"decimals": <decimals>,
"symbol_placement": "<symbol_placement>",
"symbol": "<symbol>",
"rate": <multiple_rate>
}
},
"userdata": {
"username": "<reciever_username>",
"name": "<name>",
"profile_image": "<profile_image_url>"
}
}
}

Sample Code

Node

var request = require('request');
var options = {
'method': 'GET',
'url': 'https://<domain>/<api prefix>/<version>/user/p2p/transfer/',
'headers': {
'apikey': '<apikey>',
'Authorization': 'Bearer <access token>',
},
formData: {}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
​

PHP

<?php
​
$curl = curl_init();
​
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://<domain>/<api prefix>/<version>/user/p2p/transfer/',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'apikey: <apikey>',
'Authorization: Bearer <access token>',
),
));
​
$response = curl_exec($curl);
​
curl_close($curl);
echo $response;

Error Responses

Status Code

Error Type

FIeld

Description

401

Request Failed

​

P2P transactions are disabled, Please contact your administrator.

400

Validation Error

wallet

P2P transactions are disabled for this wallet, Please contact your administrator or invalid wallet.

400

Validation Error

reciever

This field is required.

Reciever not found.

Self transfer not allowed.

P2P Transfer

post
​

β€Žhttps://<domain>/<api prefix>/<version>/user/p2p/transfer/
This API endpoint will perform a p2p transfer.
Request
Response
Request
Headers
apikey
required
string
Apikey
Authorization
required
string
Bearer access token
Body Parameters
wallet
required
string
wallet key
transfer_amount
required
string
transfer amount
reciever
required
string
reciever username
form_key
required
string
form key
token_checksum_field
required
string
token checksum
token_field
required
string
mail token
Response
200: OK
​​​​​HTTP/1.1 200 OK
Content-Type: application/json
​
Body:
{
"status_code": 200,
"errors": {},
"data": {}
}

Sample Code

Node

var request = require('request');
var options = {
'method': 'POST',
'url': 'https://<domain>/<api prefix>/<version>/user/p2p/transfer/',
'headers': {
'apikey': '<apikey>',
'Authorization': 'Bearer <access token>',
},
formData: {
'wallet': '<wallet_key>',
'transfer_amount': '<amount>',
'reciever': '<reciever_username>',
'form_key': '<form_key>',
'token_checksum_field': '<token_checksum>',
'token_field': '<token>'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});

PHP

<?php
​
$curl = curl_init();
​
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://<domain>/<api prefix>/<version>/user/p2p/transfer/',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => array('wallet' => '<wallet_key>','transfer_amount' => '<amount>','reciever' => '<reciever_username>','form_key' => '<form_key>','token_checksum_field' => '<token_cheksum>','token_field' => '<token>'),
CURLOPT_HTTPHEADER => array(
'apikey: <apikey>',
'Authorization: Bearer <access token>'
),
));
​
$response = curl_exec($curl);
​
curl_close($curl);
echo $response;

Error Responses

Status Code

Error Type

FIeld

Description

400

Validation Error

wallet

This field is required.

This field may not be blank.

P2P transactions are disabled for this wallet, Please contact your administrator or invalid wallet.

400

Validation Error

transfer_amount

This field is required.

This field may not be blank.

Minimum transaction amount is <min_amount>.

Transaction Limit is <max_amount>.

Ensure this field has no more than 7 characters.

Only integers are allowed.

Entered amount is greater than wallet balance.

Invalid amount.

400

Validation Error

reciever

This field is required.

This field may not be blank.

Reciever user not found.

Self transfer not allowed.

400

Validation Error

form_key

This field is required.

This field may not be blank.

You have another form running, Please reload.

400

Validation Error

token_checksum_field

This field is required.

This field may not be blank.

400

Validation Error

token_field

This field is required.

This field may not be blank.

Token is not matching.

Only numeric characters are allowed.

401

Request Failed

​

P2P transactions are disabled, Please contact your administrator.