Transfer to Phone Number

This API makes money transfer to cell phone number. You have to use “Execute Transaction API” for complete your transaction.

API Information

URL

 /remittanceToPhoneNumber

Method

 POST

Version

 1.0

Scope

 transfer

Authorization Flow

 Authorization Code


Input Information

Sender

Name Format Description Required/Optional

AccountNumber

 String (17) Sender account number Required


Receiver

Name Format Description Required/Optional

PhoneNumber

 String (10) Receiver cell phone number Required

IdentityNumber

 String (11) Receiver T.R. Identity number Required


FeeInformation

Name Format Description Required/Optional

AccountNumber

 String (17) Fee account number Optional


Transaction

Name Format Description Required/Optional

Amount

 Decimal (10) Transaction amount Required

Description

 String (200) Transaction description Required


Output Information

SecurityInformation

Name Format Description

OTPTransactionId

 Integer OTP transaction id

OTPStatus

 String OTP status


FeeInformation

Name Format Description

TotalFeeAmount

 Decimal Total fee amount

CurrencyCode

 String Currency code

AccountNumber

 String Fee account number

Fee

 List< Fee > Fee list

List< Fee >

Name Format Description

Amount

 Decimal Fee amount

CurrencyCode

 String Currency code

FeeDescription

 String Fee description


Transaction

Name Format Description

Amount

 Decimal Transaction amount


Receiver

Name Format Description

NameSurnameTitle

 String Masked receiver name surname / title


Execute Transaction

Sender

Name Format Description

AccountNumber

 String Sender account number


Receiver

Name Format Description

PhoneNumber

 String Receiver cell phone number

IdentityNumber

 String Receiver T.R. Identity number


Transaction

Name Format Description

TransactionId

 Integer Transaction id

Date

 yyyy-MM-ddTHH24:mm:ss Transaction date

Amount

 Decimal Transaction amount

Description

 String Transfer description


FeeInformation

Name Format Description

TotalFeeAmount

 Decimal Total fee amount

CurrencyCode

 String Currency code

AccountNumber

 String Fee account number


Message Codes

Message Code Description

ACBH000043

Sender account number cannot be empty.

ACBH000044

Sender account number format is incorrect.

ACBH000070

Receiver T.R. Identity number cannot be empty.

ACBH000071

Receiver T.R. Identity number format is incorrect.

ACBH000098

Receiver phone number cannot be empty.

ACBH000104

Account that you want to make transaction is not belong to customer in session.

ACBH000113

This transaction cannot be performed with commercial customer number.

ACBH000208

Amount must be greater than zero.

ACBH000209

Description cannot be empty.

ACBH000210

Description cannot be greater than 200.

ACBH000212

Cell phone number lenght must be 10 digits and start with 5.

ACBH000222

Sender account currency code must be TRY.

ACBH000232

Money transfer transaction can be executed by only deposit accounts in Open Banking Channel.

ACBH000264

Fee account currency code must be TRY.

ACBH000270

Sender and receiver cell phone number cannot be the same.

ACBH000277

Fee account number format is incorrect.

ACBH000283

Fee account number does not belong to customer in session.

ACBH000288

There is no customer have T.R. Identy number {0}

Example

Request:

{
    "Sender": {
        "AccountNumber": "00158000000000001"
    },
    "Receiver": {
        "IdentityNumber": "10000000000",
        "PhoneNumber": "5000000000"
    },
      "FeeInformation": {
        "AccountNumber": "00158000000000001"
    },
    "Transaction": {
        "Amount": 20,
        "Description": "Cebe para gönder"
    }
}

Response:

      
{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "7b40c4cd-205c-4f67-9bc4-572aab6b930e"
    },
    "SecurityInformation": {
        "OTPTransactionId": 195936,
        "OTPStatus": "ApprovementWaiting"
    },
    "Data": {
        "Transaction": {
            "Amount": 20
        },
        "Receiver": {
            "NameSurnameTitle": "E*H*N M*S*U*İ*"
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 5,
        "CurrencyCode": "TL",
        "Fee": {
            "CurrencyCode": "TL",
            "Amount": 5,
            "FeeDescription": "CEBE PARA GÖNDER"
        },
        "AccountNumber": "00158000000000001"
    }
}

Execute Transaction

{
    "Header": {
        "StatusCode": "APIGW000000",
        "StatusDescription": "Tamamlandı",
        "StatusDescriptionEn": "Completed",
        "ObjectID": "7945c4cd-205c-4f67-9bc4-572aab6b930e"
    },
    "Data": {
        "Sender": {
            "AccountNumber": "00158000000000001"
        },
        "Transaction": {
            "Description": "Cebe para gönder",
            "Amount": 20,
            "Date": "2021-30-03T10:32:50",
            "TransactionId": 2021000008813021
        },
        "Receiver": {
            "PhoneNumber": 5000000000,
            "IdentityNumber": 10000000000
        }
    },
    "FeeInformation": {
        "TotalFeeAmount": 5.0,
        "CurrencyCode": "TL",
        "AccountNumber": "00158000000000001"
    }
}