Төлем бетін инициализациялауды бастамас бұрын, Сізге мобильді қосымшаңызға SDK орнату керек.

SDK-да төлем бетін іске қосу бойынша нұсқаулық

Мобильді қосымшаңызда SDK баптағаннан кейін төлемнің өзін баптауға өтіңіз.

Банктік картамен төлеу
HalykQR бойынша төлем
Бөліп төлеу/кредит арқылы сатып алу
MasterPass
iOS Specific
1. Apple Pay
Android Specific
1. Google Pay
2. Samsung Pay
1. Homebank-те сақталған карталармен (тек Halyk экожүйе жүйелері үшін қол жетімді)

Төлемнің қандай да бір түрін қосу/өшіру үшін Сізге менеджеріңізге хабарласу керек.

1. Invoice инстансын инициализациялау

Төлем бетіне өтпес бұрын, Invoice моделінің инстансын инициализациялаңыз.

Жалпы жолдардың сипаттамасы:

Жол атауы	ОМіндетті параметр	Сипаттамасы
id (invoiceId)	Иә	Тапсырыс нөмірін коммерсант жасайды, әрбір жаңа тапсырыс үшін тапсырыс нөмірі бірегей, 6-дан 15 цифрға дейін болуы керек. Егер сіздің тапсырыс нөміріңізде 6-дан астам таңба болса, онда бірегейлік қосымша соңғы 6 таңба бойынша сақталуы керек
amount	Иә	Тапсырыс сомасы
currency	Иә	Валюта
postLink	Иә	Төлем туралы хабарлама
failurePostLink	Иә	Сәтсіз төлем туралы хабарлама, егер толтырылмаған болса, онда ақпарат postlink-те көрсетілген мекенжайға жіберіледі
backLink	Иә	Төлем сәтті болған кезде дүкенге оралу сілтемесі
failureBackLink	Иә	Төлем сәтсіз болған кезде дүкенге оралу сілтемесі
description	Жоқ	Тапсырыс сипаттамасы, рұқсат етілген таңбалар саны 125 байт
isRecurrent	Да	true рекуррент төлемді баптау үшін, басқалай болған жағдайда false. Әдепкі қалпы бойынша, false-ті пайдалануды ұсынамыз
autoPaymentFrequency	Жоқ	Төлемдер жиілігі: WEEKLY, MONTHLY, QUARTERLY
homebankToken	Жоқ	Homebank те сақталған карталармен төлем жасау мүмкіндігі үшін
accountId	Жоқ	Дүкен клиентінің сәйкестендіргішін көрсетуге арналған міндетті емес жол

Invoice iOS инстансын инициализациялау мысалы

Invoice төлемін инициализациялау үшін transferType=nil -ді беру керек

import EpaySDK

let invoice = Invoice(
    id: invoiceId,
    amount: amount,
    currency: "KZT",
    accountId: "1",
    description: "",
    postLink: "https://testmerchant/order/1123",
    failurePostLink: "https://testmerchant/order/1123/fail",
    isRecurrent: false,
    autoPaymentFrequency: .weekly
)

Invoice Android инстансын инициализациялау мысалы

import com.ss.halykepay.data.model.Invoice

val invoice = Invoice(
    id = invoiceId,
    amount = amount,
    currency = "KZT",
    accountID = "1",
    description = "",
    postLink = "https://testmerchant/order/1123",
    failurePostLink = "https://testmerchant/order/1123/fail",
    isRecurrent = false,
    autoPaymentFrequency = Invoice.AutoPaymentFrequency.WEEKLY
)

2. Төлем бетін іске қосу

IOS-та іске қосу мысалы

import EpaySDK

let pm = PaymentModel(authConfig: <Бұрын бапталған AuthConfig>, invoice: < жоғарыдағы тармақпен жасалған Invoice инстансы >)

let launchScreenVC = LaunchScreenViewController(paymentModel: pm)
launchScreenVC.setEnvironmetType(type: .prod) //тест үшін қолданыңыз.dev .dev
navigationController?.pushViewController(launchScreenVC, animated: true)

Android-та іске қосу мысалы

Бұрын жасалған HalykEpaySDK инстансын пайдаланып, Invoice инстансын беру арқылы төлем бетін іске қосыңыз 

halykEpaySdk.launchEpay(invoice)

3. MasterPass

Masterpass жұмысының принципі:

Мерчанттың қосымшасы сессияны, сатып алушы картасының токенін алады
Masterpass арқылы төлеу үшін деректерді SDK-ға жібереді
Клиент SDK-да әрекет жасайды және төлемді жүзеге асырады

Masterpass iOS арқылы төлемді инициализациялау

import EpaySDK

masterPass = MasterPassData(
  cardData: MasterPassCardData(
    token: "BC0B67F5F218414C8DC7AFF47ED33893", 
    CardHolder: "JON JONSON", 
    ExpiryDate: "04/24", 
    PANMask: "440563...5096", 
    CardStatus: 1),
  merchantName: "Kcell",
  session: "372d7003-fff1-4ba8-99e3-55a11532ece5",
  masterPassAction: MasterPassAction(
    SaveCard: false, 
    updateSaveCard: false, 
    recurring: false)
)

let invoice = Invoice(
  id: invoiceId,
  amount: amount,
  currency: "KZT",
  accountId: "1",
  description: "",
  postLink: "https://testmerchant/order/1123",
  failurePostLink: "https://testmerchant/order/1123/fail",
  isRecurrent: false,
  autoPaymentFrequency: .weekly,
  masterPass: masterPass
)

Masterpass Android арқылы төлемді инициализациялау

import com.ss.halykepay.data.model.Invoice
import com.ss.halykepay.data.model.MasterPass
import com.ss.halykepay.data.model.MasterPassAction
import com.ss.halykepay.data.model.MasterPassCardData

masterPass = MasterPass(
  cardData = MasterPassCardData(
    token = "BC0B67F5F218414C8DC7AFF47ED33893",
    CardHolder = "JON JONSON",
    ExpiryDate = "04/24",
    PANMask = "440563...5096",
    CardStatus = 1),
  merchantName = "Kcell",
  session = "372d7003-fff1-4ba8-99e3-55a11532ece5",
  MasterPassAction = MasterPassAction(
    SaveCard = false,
    updateSaveCard = false,
    recurring = false)
)

val invoice = Invoice(
  id = invoiceId,
  amount = amount,
  currency = "KZT",
  accountID = "1",
  description = "",
  postLink = "https://testmerchant/order/1123",
  failurePostLink = "https://testmerchant/order/1123/fail",
  isRecurrent = false,
  autoPaymentFrequency = Invoice.AutoPaymentFrequency.WEEKLY,
  masterPass = masterPass
)