Төлем бетін инициализациялауды бастамас бұрын, Сізге мобильді қосымшаңызға 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
    )