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 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 ATMs or transfer it to his/her account if s/he is a Garanti 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.garanti.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"
  }
}