KazePay
KazePay
  • Introduction
  • Quick Guide
  • Virtual Card APIs
  • Physical Card APIs
  • Webhook APIs
  • Merchant APIs
  • Appendix

Appendix

1 CardBIN#

cardbincard issuing organizationcard type
2229MasterCardVIRTUAL Card
5360MasterCardVIRTUAL Card
5258MasterCardVIRTUAL Card
4146VISAVIRTUAL Card

2 Card status#

statusdescription
AUDITINGCard approval in progress
AUDIT_PASSCard approval passed
AUDIT_NOT_PASSCard approval not passed
TBACard to be activated (automatic activation for first time card recharge)
ACTIVE_PROCESSINGCard activation processing is in progress (some cards cannot synchronously return results and need to wait for notification or actively query results)
ACTIVECard active
CLOSE_PROCESSINGCard closing processing is in progress(some cards cannot synchronously return results and need to wait for notification or actively query results)
CLOSECard been closed
EXCHANGE_PROCESSINGCard replacement processing in progress
EXPIREDCard expiration date has passed

3 Transaction status#

statusdescriptioncard type
PENDINGPendingVIRTUAL Card
APPROVEDapprovedVIRTUAL Card
DECLINEDdeclinedVIRTUAL Card
CANCELcancelVIRTUAL Card
OTHERother type statusVIRTUAL Card

4 Transaction type#

typedescriptioncard type
AUTHAuthorized consumptionVIRTUAL Card
AUTH_QUERYAuthorized queryVIRTUAL Card
REVERSALReversalVIRTUAL Card
REFUNDRefundVIRTUAL Card
FEEFeeVIRTUAL Card
TRADE_PROCESS_FEETrade process feeVIRTUAL Card
TRADE_CROSS_BOARD_FEETrade cross board feeVIRTUAL Card
TRADE_REFUND_FEETrade refund feeVIRTUAL Card
FEE_REVERSALFee reversalVIRTUAL Card
ORIGINAL_CREDITOtc refundVIRTUAL Card
ORIGINAL_CREDIT_REVERSALOtc refund reversalVIRTUAL Card
CLEARINGTrade settlementVIRTUAL Card
AUTH_FAILUREAuthorization failedVIRTUAL Card

5 Transaction return code#

codedescriptioncard type
000000SUCCESSVIRTUAL Card
100001FAILED（Account Excetion）VIRTUAL Card
200001FAILED(Invalid card)VIRTUAL Card
200002FAILED(Insufficient balance)VIRTUAL Card
200003FAILED(CVV error)VIRTUAL Card
200004FAILED(Incorrect expiration date)VIRTUAL Card
200005FAILED(Incorrect transaction currency)VIRTUAL Card
200006FAILED(Non multiple card)VIRTUAL Card
200007FAILED(Exceeding limit)VIRTUAL Card
200008FAILED(Card abnormality)VIRTUAL Card
200009FAILED(The number of transactions exceeds the limit)VIRTUAL Card
300001FAILED(Invalid Merchant)VIRTUAL Card
400001FAILED(High risk transactions)VIRTUAL Card
400002FAILED(Invalid amount)VIRTUAL Card
400003FAILED(Invalid transaction)VIRTUAL Card
400004FAILED(Unable to find original transaction)VIRTUAL Card
400005FAILED(The original transaction status is abnormal)VIRTUAL Card
400006FAILED(This transaction type is not supported)VIRTUAL Card
400007FAILED(Transaction timeout)VIRTUAL Card
400008FAILED(Rejected by risk control)VIRTUAL Card
400009FAILED(Channel interception)VIRTUAL Card
400010FAILED(Refund exceeds the limit)VIRTUAL Card
400011FAILED(Frequent authorization)VIRTUAL Card
400012FAILED(Decision rejection)VIRTUAL Card
400013FAILED(Payment request occurs again after correction)VIRTUAL Card
999997FAILED(Channel abnormality)VIRTUAL Card
999998FAILED(System upgrade in progress)VIRTUAL Card
999999FAILED(Unknown exception)VIRTUAL Card

6 KYC status#

statusdescription
NEWNewly created account, KYC verification has not yet started
INITThe verification link has been obtained and verification is starting.
WAITING_KYCValidation has started and we are waiting for the results.
RESUBMISSIONDuring the verification process, additional materials are needed. You can use the previous verification link to supplement the materials.
REJECTEDREJECTED
PASSEDPASSED
EXPIREDOperation Timeout

7 Auth Result#

statusdescription
UNAUTHORIZEDUnauthorized
AUTHORIZEDAuthorized
AUTHORIZATION_CANCELEDDenied
AUTHORIZATION_TIMEOUTTimeout

8 Country Code#

CountryISO3166
AF004
AL008
DZ012
AS016
AD020
AO024
AI660
AQ010
AG028
AR032
AM051
AW533
AU036
AT040
AZ031
BS044
BH048
BD050
BB052
BY112
BE056
BZ084
BJ204
BM060
BT064
BO068
BA070
BW072
BR076
IO086
BN096
BG100
BF854
BI108
KH116
CM120
CA124
CV132
KY136
CF140
TD148
CL152
CN156
CX162
CO170
KM174
CG178
CD180
CK184
CR188
CI384
HR191
CU192
CY196
CZ203
DK208
DJ262
DM212
DO214
EC218
EG818
SV222
GQ226
ER232
EE233
ET231
FK238
FO234
FJ242
FI246
FR250
GF254
PF258
GA266
GM270
GE268
DE276
GH288
GI292
GR300
GL304
GD308
GP312
GU316
GT320
GN324
GW624
GY328
HT332
VA336
HN340
HK344
HU348
IS352
IN356
ID360
IR364
IQ368
IE372
IL376
IT380
JM388
JP392
JO400
KZ398
KE404
KI296
KP408
KR410
KW174
KG417
LA418
LV428
LB422
LS426
LR430
LY434
LI438
LT440
LU442
MO446
MK807
MG450
MW454
MY458
MV462
ML466
MT470
MH584
MQ474
MR478
MU480
YT175
MX484
FM583
MD498
MC492
MN496
MS500
MA504
MZ508
MM104
NA516
NR520
NP524
NL528
NC540
NZ554
NI558
NE562
NG566
NU570
NF574
MP580
NO578
OM512
PK586
PW585
PA591
PG598
PY600
PE604
PH608
PL616
PT620
PR630
QA634
RE638
RO642
RU643
RW646
SH654
KN659
LC662
PM666
VC670
WS882
SM674
ST678
SA682
SN686
SC690
SL694
SG702
SK703
SI705
SB090
SO706
ZA710
ES724
LK144
SD729
SR740
SZ748
SE752
CH756
SY760
TW158
TJ762
TZ834
TH764
TL626
TG768
TK772
TO776
TT780
TN788
TR792
TM795
TC796
TV798
UG800
UA804
AE784
GB826
US840
UY858
UZ860
VU548
VE862
VN704
VG092
VI850
WF876
YE887
ZM894
ZW716
GG831
ME499
PS275
RS688
Modified at 2025-03-28 11:39:05
Previous
Merchant APIs
Built with