tl TL
tl TL en_US EN sw SW
Mag log in
Magrehistro

Kailangan mo ng gabay?

Sumulat ng paksang nauugnay sa iyong tanong sa ibaba upang mahanap ang iyong sagot.

Mga Endpoint ng Transaksyon (api/Transaction)

Pangkalahatang Kahulugan

ParameterPaglalarawan
baseurlSandbox – https://test.xprizo.com/apiLive- https://wallet.xprizo.com/api
apiversion1.0
apikeyAPI key Para sa pagpapatunay

Lumikha ng Kahilingan sa Deposit Gamit ang Card

Hiling

kulot --lokasyon '{baseurl}/Transaction/CardDeposit' \
--header 'Tanggapin: text/plain; x-api-version=1.0' \
--header 'Uri ng Nilalaman: application/json; x-api-version=1.0' \
--header 'x-api-version: {apiversion}' \
--header 'x-api-key: {apikey}' \
--datos '{
 "paglalarawan": <purpose ng deposito>,
 "sanggunian": <unique sanggunian>,
 "halaga": <the deposito halaga>,
 "Account ID": <merchants wallet id>,
 "customer": <unique pangalan para sa ang depositor>,
 "creditCard": {
 "pangalan": <name sa card>,
 "numero": <card numero>,
 "expiryMonth":<2 digit na expiry month 01-12>,
 "expiryYear": <2 diget na taon ng expiry>,
 "cvv": <3 o 4 na digit>
 },
 "routingCode": "string",
 "redirect": "string"
}'

ParameterPaglalarawan
Account ID(Kinakailangan) Ito ang ID ng wallet ng tatanggap – ang wallet kung saan idedeposito ang mga pondo.
sanggunian(Kinakailangan) Ang reference ay ang natatanging identifier ng transaksyon para sa transaksyong ito. Ito ay bubuo ng gumagamit ng processor at gagamitin sa mga pagsusuri sa status at mga callback.
customer(Kinakailangan) Isang natatanging identifier ng taong gumagawa ng deposito. Kung hindi mahanap ang customer na ito sa system, idaragdag sila sa address book ng tatanggap. Maaari mong ipasa ang email id ng user na iyon.
halaga(Kinakailangan) Ang halaga ng deposito, na may 2 decimal na lugar, gamit ang tuldok bilang decimal.
paglalarawan(Opsyonal) Text na maaaring gamitin upang ilarawan ang dahilan ng deposito. Nasa Test Mode. gamitin:-
Pass, Tagumpay – ang transaksyon ay gagawin bilang naaprubahan. Tanggihan, Nabigo, Kanselahin – ang transaksyon ay gagawin at pagkatapos ay tatanggihan.
routingCodeGamitin ang isa sa mga routing code na itinakda sa iyong account (ginagamit ang mga routing code para sa iba't ibang currency at limitasyon). Ito ay iko-configure ng Xprizo Team at mahahanap mo ang mga ito dito.
pag-redirect(Kinakailangan para sa 3DS) Kung ang card ay naproseso gamit ang 3ds, kakailanganin mong magbukas ng screen ng kumpirmasyon (ang redirect URL para sa screen ng kumpirmasyon ay ibinalik bilang tugon sa kahilingang ito). Ang pag-redirect na ito ay ang URL kung saan ibabalik ang user pagkatapos maisara ang screen ng kumpirmasyon.

Tugon (200)

{
    "susi": <a kakaiba identifier para sa ang transaksyon>,
    "statusCode": <Ang numero katumbas ng ang Katayuan>,
    "katayuan": ,
    "halaga":
}

ParameterPaglalarawan
susiisang natatanging identifier para sa transaksyon
statusCodeAng numerong katumbas ng Status
katayuanAktibo – Matagumpay na nakumpleto ang transaksyon Nakabinbin – Hindi nakumpleto ang transaksyon at nangangailangan ng karagdagang pagkilos Tinanggihan – Tinanggihan ang transaksyonRedirect – (3DS) kailangang i-redirect ang user sa ibang URL upang makumpleto ang transaksyon
halagaAktibo – ipapakita ng value ang paglalarawanNakabinbin – ipapakita ng value ang paglalarawanRejected – ipapakita ng value ang reasonRedirect – ipapakita ng value ang URL na ire-redirect sa

Mga pagkakamali

  • 400 (Bad Request) Hindi makumpleto ang transaksyon. Ibinalik ang dahilan. Suriin ang error, makipag-ugnayan sa Xprizo, o ayusin ang problema at subukang muli.
    • MensaheDetalye ng MensaheDi-wastong routing codeAng iyong account ay walang routing code na naka-configure. Mangyaring makipag-ugnayan sa Xprizo team upang mai-set up ito. Di-wastong routing code (Walang Mid Set)Ang iyong account ay walang MID na naka-configure. Mangyaring makipag-ugnayan sa Xprizo team para ma-configure ito. Umiiral na ang isang transaksyon na may ganitong referenceKailangan mong bumuo ng bagong reference at subukang muliAng isang nakabinbing transaksyon na may ganitong reference ay mayroon na (Ref:652-1706532591287))Ang transaksyon ay available na para dito reference number na may status na nakabinbin, pakisuri ang status nito o subukang muli gamit ang bagong reference number 
  • 401 (Hindi awtorisado) Di-wasto o nag-expire na token.
  • 403 (Bawal) Wala kang karapatang likhain o aprubahan ang transaksyong ito.
  • 500 (Internal Server Error) Isang kritikal na hindi inaasahang error sa system ang naganap. Makipag-ugnayan sa Xprizo at iulat ang error.

Gumawa ng Kahilingan sa Deposit Gamit ang Xprizo Wallet

Hiling

kulot --lokasyon '{baseurl}/Transaction/RequestPayment' \
--header 'Tanggapin: text/plain; x-api-version=1.0' \
--header 'Uri ng Nilalaman: application/json; x-api-version=1.0' \
--header 'x-api-version: {apiversion}' \
--header 'x-api-key: {apikey}' \
--datos '{
    "mula saAccountId": <users_account_id>,
    "toAccountId": <your_account_id>,
    "paglalarawan": <purpose ng deposito>,
    "halaga": <requested halaga>,
    "sanggunian":<unique sanggunian>
}'

ParameterPaglalarawan
mula saAccountIdIto ang ID ng wallet ng nagbabayad – ang user na nagbabayad ng mga pondo
saAccountIdIto ang ID ng wallet ng tatanggap – ang user na tatanggap ng mga pondo
paglalarawan(Opsyonal) Text na maaaring gamitin upang ilarawan ang dahilan ng transaksyon
halagaAng halaga ng transaksyon
sanggunianAng isang natatanging sanggunian ay nilikha upang matukoy mo at maiugnay ang transaksyong ito sa iyong system

Tugon (200)

{
    "susi":<a kakaiba identifier para sa ang transaksyon>,
    "approveById": <id ng ang tao sa aprubahan ang transaksyon>,
    "canCancel": <can maging kinansela o hindi>,
    "ttl": <time umalis sa segundo>,
    "expireDate": ,
    "error": ""
}

ParameterPaglalarawan
susiisang natatanging identifier para sa transaksyon
approveById<id of the person to approve the transaction>
canCancel<can be cancelled or not>
expiryDate<date/time when the transaction expires>
ttl<time left in seconds>

Mga pagkakamali

  • 400 (Bad Request) Hindi makumpleto ang transaksyon. Ibinalik ang dahilan. Suriin ang error, makipag-ugnayan sa Xprizo, o ayusin ang problema at subukang muli.
  • 401 (Hindi awtorisado) Di-wasto o nag-expire na token.
  • 403 (Bawal) Wala kang karapatang likhain o aprubahan ang transaksyong ito.
  • 500 (Internal Server Error) Isang kritikal na hindi inaasahang error sa system ang naganap. Makipag-ugnayan sa Xprizo at iulat ang error.

Lumikha ng Kahilingan sa Deposit Gamit ang Mpesa Wallet

Hiling

kulot --lokasyon '{baseurl}/Transaction/MPesaDeposit' \
--header 'Tanggapin: text/plain; x-api-version=1.0' \
--header 'Uri ng Nilalaman: application/json; x-api-version=1.0' \
--header 'x-api-version: {apiversion}' \
--header 'x-api-key: {apikey}' \
--datos '{
    "mobileNumber": <mpesa_mobile_number>,
    "Account ID": <your_account_id>,
    "paglalarawan": <purpose ng deposito>,
    "halaga": <requested halaga>,
    "sanggunian":<unique sanggunian>
}'

ParameterPaglalarawan
mobileNumberNumero ng Mpesa Mobile na gagamitin para sa transaksyon
Account IDIto ang ID ng wallet ng tatanggap – ang user na tatanggap ng mga pondo
paglalarawan(Opsyonal) Text na maaaring gamitin upang ilarawan ang dahilan ng transaksyon. Nasa Test Mode. gamitin:-
Pass, Tagumpay – ang transaksyon ay gagawin bilang naaprubahan. Tanggihan, Nabigo, Kanselahin – ang transaksyon ay gagawin at pagkatapos ay tatanggihan.
halagaAng halaga ng transaksyon
sanggunianAng isang natatanging sanggunian ay nilikha upang matukoy mo at maiugnay ang transaksyong ito sa iyong system

Tugon (200)

{
    "susi": <a kakaiba identifier para sa ang transaksyon>,
    "statusCode": <Ang numero katumbas ng ang Katayuan>,
    "katayuan": ,
    "halaga": <transaction paglalarawan>
}

ParameterPaglalarawan
susiisang natatanging identifier para sa transaksyon
statusCodeAng numerong katumbas ng Status
katayuanAktibo – Matagumpay na nakumpleto ang transaksyon Nakabinbin – Hindi nakumpleto ang transaksyon at nangangailangan ng karagdagang pagkilos Tinanggihan – Tinanggihan ang transaksyon
halagaAktibo – ipapakita ng value ang paglalarawanNakabinbin – ipapakita ng value ang paglalarawanRejected – ipapakita ng value ang dahilan

Mga pagkakamali

  • 400 (Bad Request) Hindi makumpleto ang transaksyon. Ibinalik ang dahilan. Suriin ang error, makipag-ugnayan sa Xprizo, o ayusin ang problema at subukang muli.
  • 401 (Hindi awtorisado) Di-wasto o nag-expire na token.
  • 403 (Bawal) Wala kang karapatang likhain o aprubahan ang transaksyong ito.
  • 500 (Internal Server Error) Isang kritikal na hindi inaasahang error sa system ang naganap. Makipag-ugnayan sa Xprizo at iulat ang error.

Pag-apruba ng Mga Tugon sa Webhook

Gumawa ng Transaksyon at Inaprubahang Tugon sa Transaksyon sa Webhook (Sample)

# Nilikha Transaksyon
{
  "statusType": 1,
  "katayuan": "Bago",
  "paglalarawan": wala,
  "actionedById": 724,
  "apektadoContactIds": [
    723,
    2
  ],
  "transaksyon": {
    "id": 0,
    "nilikhaById": 724,
    "uri": "UCD",
    "petsa": "2024-02-07T03:41:59.823195+00:00",
    "sanggunian": "652-1706532591283",
    "currencyCode": "USD",
    "halaga": 5
  }
}

# Naaprubahan Transaksyon
{
  "statusType": 2,
  "katayuan": "Tinanggap",
  "paglalarawan": wala,
  "apektadoContactIds": [
    723,
    2
  ],
  "transaksyon": {
    "id": 3169,
    "nilikhaById": 724,
    "uri": "UCD",
    "petsa": "2024-02-07T03:43:50.9186754+00:00",
    "sanggunian": "652-1706532591283",
    "currencyCode": "USD",
    "halaga": 5
  }
}

ParameterPaglalarawan
statusTypeIto ang status 2 = Tinanggap
katayuanText na bersyon ng status na "Tinanggap"
apektadoContactIdsIsang listahan ng mga contact ID na kasangkot sa transaksyong ito
Transaksyon Transaksyon na ginawa
idAng natatanging Id ng transaksyon na ibinigay ng Xprizo
nilikhaByIdId ng taong lumikha ng transaksyon
uriAng uri ng transaksyon (UCD = Card Deposit) 
petsaAng petsa ng transaksyon
sanggunianAng natatanging identifier ng transaksyon ng tatanggap para sa transaksyong ito
currencyCodeAng pera ng transaksyong ito
halagaAng halaga ng transaksyong ito

Tinanggihan ang Tugon sa Transaksyon sa Webhook (Sample)

{
 "statusType":3,
 "katayuan":"Tinanggihan",
 "paglalarawan":"Dahilan ng pagtanggi",
 "actionedById":1,
 "apektadoContactIds":[]
 "transaksyon": {
   "id":0,
   "nilikhaById":2,
   "uri":"UCD",
   "petsa":"2021-04-20T20:34:00.7606173+02:00",
   "sanggunian":234234234,
   "currencyCode":"USD",
   "halaga":100.00
 }
}

Ang sumusunod ay isang listahan ng mga approval status code na maaaring ibalik

  • 0 = Wala – Ginagamit para sa pagsubok
  • 1 = Bago – Isang bagong nakabinbing transaksyon ang nalikha
  • 2 = Naaprubahan- Ang transaksyon ay naaprubahan at naproseso
  • 3 = Tinanggihan - Ang transaksyon ay tinanggihan ng nakakuha
  • 4 = Kinansela – Kinansela ng gumawa ang transaksyon

Pagsusuri sa Katayuan ng Transaksyon

Maaaring gamitin ang endpoint na ito upang suriin ang katayuan ng anumang uri ng transaksyon halimbawa card deposit, Mpesa withdrawal atbp.

Hiling

kulot --lokasyon '{baseurl}/Transaction/Status/{accountId}/?reference={reference}' \
--header 'x-api-version: {apiversion}' \
--header 'x-api-key: {apikey}'

ParameterPaglalarawan
Account IDIto ang ID ng wallet na naglalaman ng transaksyon. Kapag humihiling ng pagbabayad, gamitin ang ID ng wallet ng tatanggap.
sanggunianAng sanggunian ay ang natatanging pagkakakilanlan ng transaksyon ng Merchants para sa transaksyong ito

Tugon (200)

{
    "susi" : <a kakaiba identifier para sa ang transaksyon>
    "statusCode" : <0/3/1/-1/4/5/6>
    "katayuan":
    "halaga":
}

# Nakabinbing Transaksyon 

{
    "susi": "",
    "statusCode": 1,
    "katayuan": "Nakabinbin",
    "halaga": "Pass"
}


Inaprubahan ng # na Transaksyon

{
    "susi": "3169",
    "statusCode": 0,
    "katayuan": "Aktibo",
    "halaga": "testing.com Pass"
}

# Tinanggihang Transaksyon

{
    "susi": "144",
    "statusCode": 3,
    "katayuan": "Tinanggihan",
    "halaga": "Nabigo ang Pagsusulit"
}

Hindi Nahanap na Transaksyon ang #

{
    "susi": "",
    "statusCode": -1,
    "katayuan": "Hindi mahanap",
    "halaga": ""
}

# Hold Transaction (Pag-withdraw ng Mpesa)

{
    "susi": "144",
    "statusCode": 5,
    "katayuan": "Hawakan",
    "halaga": "Mpesa Withdrawal +254342222222"
}

# Void Transaction (Pag-withdraw ng Mpesa)

{
    "susi": "144",
    "statusCode": 6,
    "katayuan": "walang bisa",
    "halaga": "342222222 Voided: Walang Data ng Tugon"
}

ParameterPaglalarawan
susiIto ang natatanging ID ng transaksyon. Kapag Aktibo o Hold o Void, maglalaman ito ng transaction ID
Kapag Tinanggihan o Kinansela, ito ang magiging ID na ibinigay sa log file para sa entry. Kapag nakabinbin o NotFound, ito ay magiging blangko.
katayuan Ang katayuan ng transaksyon – Ito ay maaaring isa sa mga sumusunod: Aktibo – Ang transaksyon ay isang wastong aktibong transaksyon Nakabinbin – Ang transaksyon ay naghihintay ng pag-apruba (o pagtanggi).NotFound – Isang transaksyon sa wallet na ito, na may ganitong reference ay hindi umiiral. Tinanggihan – ang transaksyon ay tinanggihan ng nakakuha. Kinansela – Kung kinansela ng Xprizo ang transaksyon dahil sa teknikal na error o di-wastong mga tawag.Hold – Ito ay naaangkop para sa Mpesa withdrawal 
halagaKapag Aktibo, maglalaman ito ng paglalarawan sa pagsingil Para sa deposito sa card at paglalarawan ng transaksyon para sa iba pang mga transaksyon. Kapag Na-hold ito ay maglalaman ng paglalarawan ng pag-withdraw. maging blangko

Test Configuration Para sa Routing Options

Pagpipilian sa Pagruruta Prefix ng Routing Code Configuration
Pagpipilian ALALAKIHalaga$1.00 o $2.00 – Aktibo( 2DS Success)$3.00 o $4.00 – Tinanggihan$5.00 o $6.00 – Rdirect (3DS Redirect URL)$7.00 o mas mataas – Tinanggihan na Kaso Sa 3DS
Nakatulong ba ang manwal na ito?

Galugarin ang iba pang mga manwal

Mga Endpoint ng Wallet (api/Wallet)

Pangkalahatang Depinisyon Parameter Paglalarawan baseurl Sandbox – https://test.xprizo.com/apiLive- https://wallet.xprizo.com/api apiversion 1.0 apikey API…

Magbasa pa

Mga Endpoint ng Kagustuhan (api/Preference)

Pangkalahatang Depinisyon Parameter Paglalarawan baseurl Sandbox – https://test.xprizo.com/apiLive- https://wallet.xprizo.com/api apiversion 1.0 apikey API…

Magbasa pa

Mga Endpoint ng Transaksyon (api/Transaction)

Pangkalahatang Depinisyon Parameter Paglalarawan baseurl Sandbox – https://test.xprizo.com/apiLive- https://wallet.xprizo.com/api apiversion 1.0 apikey API…

Magbasa pa

Pag-navigate

kumpanya

Tulong

Mga download

Legal

Facebook Instagram Linkin X-twitter Discord
© 2024 Xprizo. Lahat ng Karapatan ay Nakalaan.
Ang XPRIZO ay isang provider ng mga solusyon sa teknolohiya ng pagbabayad na tumatakbo sa maraming internasyonal na hurisdiksyon. Ang Kenyan operation nito ay kasabay ng Webtribe Limited na ang serbisyo ay lisensyado ng Central Bank of Kenya (Authorization certificate No. NPS/14/14/2024) sa ilalim ng National Payment Systems Act of Kenya (no. 39 ng 2011)
Kasosyo ng: In-Solutions Global Limited Suite 601/602/618, 6th Floor Palm Spring Center, Malad Link Road Mumbai 400064 Maharashtra, India. Ang kumpanya ay tumatanggap lamang ng mga pagbabayad sa Crypto sa mga hurisdiksyon kung saan ito ay legal na gawin ito.
Mag log in
Magrehistro