Cepbank Send Money
Service Description
CepBank Send Money is a money transfer service that uses phone numbers to send and receive money. The sender must be a Garanti BBVA CepBank customer while the receiver could be anyone. User enters his/her phone number (as sender), receiver phone number and the amount. A confirmation SMS is sent to user asking his/her CepBank PIN. User replies the SMS with his/her CepBank PIN. After PIN verification, money transfer is realized and the receiver takes an informative SMS. Receiver can withdraw the money from Garanti BBVA ATMs or transfer it to his/her account if s/he is a Garanti BBVA customer. If receiver does not withdraw the money or transfer it to his/her account within a week, money is sent back to sender’s account.
|
API Profile |
|
|---|---|
|
Attribute |
Value |
| Name | SendMoney |
| Version | V1 |
| Synopsis | CepBank Send Money Service |
| Description | Sending money to mobile phone number |
| Pre-Conditions | HTTP POST method is allowed only in SendMoney service. |
| Authentication | OAuth 2.0 with Client Credentials |
Before your application can access the API, it must obtain a new access token for each request. The access token can be used only one time
Endpoint Definition
CepBank Send Money API’s development live and mock environments routing data
|
EndPoint SERVICE |
|
|---|---|
| URI | /payments/v1/sendMoney |
| Base URL | https://apis.garantibbva.com.tr |
Technology
|
Technology Stack / DESIGN TIME |
|
|---|---|
| Property | Value |
| HTTP Call Method | POST |
| Response Content Type | application/json; charset=utf-8 |
Request
HTTP POST method is allowed only in Send Money service.
https://{baseURL}/payments/v1/sendMoney
Arguments
The list of arguments by the Send Money service to be invoked
| Request Fields | Type | Description | Obligation |
|---|---|---|---|
| UniqueUserID | String | Unique User ID | Mandatory |
| FirmCode | String | Firm code defined by GT and assigned to 3rd party | Mandatory |
| SenderMSISDN | String | Sender’s GSM number. 10 characters long. Numeric. | Mandatory |
| RecipientMSISDN | String | Receipient’s GSM number. 10 characters long. Numeric. | Mandatory |
| Amount | String | Amount to be sent. 1-4 characters long. Numeric. | Mandatory |
Sample Arguments
Sample data which can be used to call the API
|
Argument |
Value |
|---|---|
| UniqueUserID | user345668 |
| FirmCode | TESTFIRM |
| SenderMSISDN | 5358103651 |
| RecipientMSISDN | 5058234251 |
| Amount | 10 |
Sample Request
{
"UniqueUserID":"user345668",
"FirmCode":"TESTFIRM",
"SenderMSISDN":"5358103651",
"RecipientMSISDN":"5058234251",
"Amount":"10"
}
Response
The Send Money service is return the request accepted message
Sample Response
{
"result": {
"code": 202,
"info": "The request has been received"
}
}
Return Codes & Error Handling
Response codes from Send Money service request
|
Code |
Description |
Type |
|---|---|---|
| 202 | The request has been received | ACCEPTED SUCCESS |
| 405 | {http.method} Method Not Allowed | CALL METHOD ERROR |
| 400 | Invalid Request | MISSING PARAMETERS |
| 401 | Invalid Credentials | UNAUTHORIZED |
| 402 | API plan limit exceeded | RATE LIMITING |
| 500 | Internal Server Error | SYSTEM ERROR |
Return Messages
|
CODE |
RETURN RESPONSE |
|---|---|
| 202 |
{
"result": {
"code": 202,
"info": "The request has been received"
}
}
|
| 405 |
{
"result": {
"code": 405,
"info": "GET Method Not Allowed"
}
}
|
| 400 |
{
"result": {
"code": 400,
"info": "Invalid Request"
}
}
|
| 429 |
{
"result": {
"code": 429,
"info": "API plan limit exceeded"
}
}
|
| 500 |
{
"result": {
"code": 500,
"info": "Internal Server Error"
}
}
|
-
API URL : https://apis.garantibbva.com.tr:443
-
-
-