9.3) Core Web Services – Balance Object(NEW)

GetRequest Method

The getrequest service will return all the information about a specific balance transfer. From the reply you can determine the status of the request and the date of its confirmation. There are two types of balance transfer – direct or upon request – a direct transfer occurs when user pushes, an amount to another user , without a request.

Request Fields

FieldName	Mandatory?	Field Type	Description	Sample
requestId	No	Int		“6224A847-4867-41EE-851D-36CC8BA1B”

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRequest");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "requestId": intrn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRequest");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "requestId": intrn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/GetRequest",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "requestId": intrn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/GetRequest",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "requestId": intrn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRequest",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "requestId": intrn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRequest",

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 =>"{rn "requestId": intrn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

GetRequests Method

Allows to call for all requests by a certain currency or payment method limited to the logged in user – the service allows limits to be applied to the number of items per page.

Request Fields

FieldName	Mandatory?	Field Type	Sample
filters	No	array	“6224A847-4867-41EE-851D-36CC8BA1B”
CurrentIso	No	string	GBP
StoredPaymentMethodID	No	int
sortAndPage	No	array
PageNumber	No	int
PageSize	No	int

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRequests");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRequests");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/GetRequests",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/GetRequests",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRequests",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRequests",

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 =>"{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

GetRows Method

The service will return all types of balance changes to the user, with information relevant to the “source type” . Once the source type has been identified, you can call another service with the source ID to retrieve the relevant information you need. The “source types” are:

System.Admin
System.Deposit
System.DepositFee
System.PedingCapture
System.Purchase
System.Transfer
System.TransferFee
System.Withdrawal
System.WithdrawalFee
Wires.AffiliateSettlement
Wires.PaymentRequest,
Wires.Settlement
Wires.SettlementFee
Wires.Wire

Request Fields

FieldName	Mandatory?	Field Type	Sample
filters	No	array	“6224A847-4867-41EE-851D-36CC8BA1B”
CurrentIso	No	string	GBP
StoredPaymentMethodID	No	int
sortAndPage	No	array
PageNumber	No	int
PageSize	No	int

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRows");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetRows");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/GetRows",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/GetRows",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRows",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "filters": {rn    "CurrencyIso": "string",rn    "StoredPaymentMethodID": intrn  },rn  "sortAndPage": {rn    "PageNumber": int,rn    "PageSize": intrn  }rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetRows",

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 =>"{rn "filters": {rn "CurrencyIso": "string",rn "StoredPaymentMethodID": intrn },rn "sortAndPage": {rn "PageNumber": int,rn "PageSize": intrn }rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

GetTotal Method

The service returns the total available balance for the user – per currency

Request Fields

FieldName	Mandatory?	Field Type	Description	Sample
currencyIsoCode	No	string		GBP

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetTotal");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "currencyIsoCode": "string"rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/GetTotal");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "currencyIsoCode": "string"rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/GetTotal",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": JSON.stringify({"currencyIsoCode":"string"}),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/GetTotal",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": JSON.stringify({"currencyIsoCode":"string"}),

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetTotal",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "currencyIsoCode": "string"rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/GetTotal",

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 =>"{rn "currencyIsoCode": "string"rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

ReplyRequest Method

Once a request for an amount reaches a user , there is the option to reply either “yes” or “no” – and reply must be approved by the user using the pin code.

Request Fields

FieldName	Mandatory?	Field Type	Sample
requestId	No	int	“6224A847-4867-41EE-851D-36CC8BA1B”
Approve	No	boolean
pinCode	No	string
Text	No	string

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "requestId": int,rn  "approve": boolean,rn  "pinCode": "string",rn  "text": "string"rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "requestId": int,rn "approve": boolean,rn "pinCode": "string",rn "text": "string"rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "requestId": int,rn  "approve": boolean,rn  "pinCode": "string",rn  "text": "string"rn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "requestId": int,rn "approve": boolean,rn "pinCode": "string",rn "text": "string"rn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "requestId": int,rn  "approve": boolean,rn  "pinCode": "string",rn  "text": "string"rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/ReplyRequest",

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 =>"{rn "requestId": int,rn "approve": boolean,rn "pinCode": "string",rn "text": "string"rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

RequestAmount Method

The basis of the balance service is to allow users to assist other users and transfer money from one another. The request amount gives the user an option to ask for an amount from‘friends’ (Friends service will be described separately in the Customer’s service)

Request Fields

FieldName	Mandatory?	Field Type	Sample
destAccountId	No	string	“6224A847-4867-41EE-851D-36CC8BA1B”
Amount	No	decimal
currencyIso	No	string	GBP

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/RequestAmount");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "text": "string"rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/RequestAmount");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "text": "string"rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/RequestAmount",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "text": "string"rn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/RequestAmount",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "text": "string"rn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/RequestAmount",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "text": "string"rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/RequestAmount",

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 =>"{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "text": "string"rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;

TransferAmount Method

This service call will allow a user to “push” an amount to another user with an original request. The user will be prompted for a Pin code to approve the transfer, in the same manner as all balance transfer requests. Even push transfers have a request ID (number), so that the request can be tracked at a later stage

Request Fields

FieldName	Mandatory?	Field Type	Sample
destAccountId	No	string
Amount	No	decimal
currencyIso	No	string	GBP
pinCode	No	string
Text	No	string

Response Fields

Field Name	Field Type	Description
Code	Integer
IsSuccess	Boolean
Key	String
Message	String	See Return Codes Table*
Number	String

C#JavaScriptPHP

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/TransferAmount");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");
request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");
request.AddParameter("application/json", "{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "pinCode": "string",rn  "text": "string"rn}",  ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

1

2

3

4

5

6

7

8

9

var client = new RestClient("https://webservices.gr8pay.com/v2/balance.svc/TransferAmount");

client.Timeout = -1;

var request = new RestRequest(Method.POST);

request.AddHeader("Content-Type", "application/json");

request.AddHeader("applicationToken", "fed45b9d-429f-449e-96a7-48ea02d8156a");

request.AddHeader("your_app_Token", "fd8e72b2-a769-4d2b-a656-f54001aaeaf5");

request.AddParameter("application/json", "{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "pinCode": "string",rn "text": "string"rn}", ParameterType.RequestBody);

IRestResponse response = client.Execute(request);

Console.WriteLine(response.Content);

var settings = {
  "url": "https://webservices.gr8pay.com/v2/balance.svc/TransferAmount",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  },
  "data": "{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "pinCode": "string",rn  "text": "string"rn}",
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

var settings = {

"url": "https://webservices.gr8pay.com/v2/balance.svc/TransferAmount",

"method": "POST",

"timeout": 0,

"headers": {

"Content-Type": "application/json",

"applicationToken": "fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token": "fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

},

"data": "{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "pinCode": "string",rn "text": "string"rn}",

};

$.ajax(settings).done(function (response) {

console.log(response);

});

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/TransferAmount",
  CURLOPT_RETURNTRANSFER =&gt; true,
  CURLOPT_ENCODING =&gt; "",
  CURLOPT_MAXREDIRS =&gt; 10,
  CURLOPT_TIMEOUT =&gt; 0,
  CURLOPT_FOLLOWLOCATION =&gt; true,
  CURLOPT_HTTP_VERSION =&gt; CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST =&gt; "POST",
  CURLOPT_POSTFIELDS =&gt;"{rn  "destAccountId": "string",rn  "amount": decimal,rn  "currencyIso": "string",rn  "pinCode": "string",rn  "text": "string"rn}",
  CURLOPT_HTTPHEADER =&gt; array(
    "Content-Type: application/json",
    "applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",
    "your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

<!--?php

$curl = curl_init();

curl_setopt_array($curl, array(

CURLOPT_URL =--> "https://webservices.gr8pay.com/v2/balance.svc/TransferAmount",

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 =>"{rn "destAccountId": "string",rn "amount": decimal,rn "currencyIso": "string",rn "pinCode": "string",rn "text": "string"rn}",

CURLOPT_HTTPHEADER => array(

"Content-Type: application/json",

"applicationToken: fed45b9d-429f-449e-96a7-48ea02d8156a",

"your_app_Token: fd8e72b2-a769-4d2b-a656-f54001aaeaf5"

),

));

$response = curl_exec($curl);

curl_close($curl);

echo $response;