PayStar API Documentation
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Callbacks
    • Telecom operators
    • Payment history
    • Error descriptions
    • Tech FAQ
    • Events
    • Balance H2H
      GET
    • Deposit H2H - ECOM (with PCI) / P2P / Online
      POST
    • Deposit H2H - ECOM by Card token (without PCI)
      POST
    • Deposit H2C - ECOM (without PCI)
      POST
    • Deposit status H2H - PayStar ID
      GET
    • Deposit status H2H - Merch ID
      GET
    • Payout H2H
      POST
    • Payout status H2H - PayStar ID
      GET
    • Payout status H2H - Merch ID
      GET

    Currencies

    INFO
    This section lists all currencies supported by the PayStar platform for payment and payout operations. Use these currency codes when specifying transaction amounts in your API requests to ensure compatibility and successful processing.
    When creating a payment request, it is mandatory to specify the payment currency in the following methods:
    Deposit H2H - Card & P2P — hosted on the secure subdomain. Requires the merchant to have a PCI DSS certificate and allows direct card data transmission between servers (host-to-host).
    Deposit H2H - Token — hosted on the token subdomain. Enables recurring payments using previously obtained tokens.
    Deposit H2С - Card — hosted on the init subdomain. Does not require PCI DSS. Used to initiate a payment without card data; the user is then redirected to a web form to enter card details.
    Payout H2H — hosted on the secure subdomain.
    Currencies must be specified using the ISO 4217 standard.
    Below is the complete list of currencies supported by the system.

    How to use currency example#

    Here's an example of a query using currency:
    curl --request POST \
     --url https://secure.PayStar.uk/api/v1/integration/deposit-order \
     --header 'Authorization: Bearer YOUR TOKEN' \
     --header 'Content-Type: application/json' \
     --header 'accept: text/plain' \
     --data '{
      "amount": 100
      "currency": "USD"
    }'

    Сurrency dictionary#

    Here is a list of currency codes as defined by the ISO 4217 standard:
    DOWNLOAD
    Currencies.json - download the full list of Currencies in a single JSON file.
    ValueDescription
    AEDUAE Dirham, 784
    AFNAfghani, 971
    ALLLek, 8
    AMDArmenian Dram, 51
    ANGNetherlands Antillean Guilder, 532
    AOAKwanza, 973
    ARSArgentine Peso, 32
    AUDAustralian Dollar, 36
    AWGAruban Florin, 533
    AZNAzerbaijan Manat, 944
    BAMConvertible Mark, 977
    BBDBarbados Dollar, 52
    BDTTaka, 50
    BGNBulgarian Lev, 975
    BHDBahraini Dinar, 48
    BIFBurundi Franc, 108
    BMDBermudian Dollar, 60
    BNDBrunei Dollar, 96
    BOBBoliviano, 68
    BOVMvdol, 984
    BRLBrazilian Real, 986
    BSDBahamian Dollar, 44
    BTNNgultrum, 64
    BWPPula, 72
    BYNBelarusian Ruble, 933
    BZDBelize Dollar, 84
    CADCanadian Dollar, 124
    CDFCongolese Franc, 976
    CHEWIR Euro, 947
    CHFSwiss Franc, 756
    CHWWIR Franc, 948
    CLFUnidad de Fomento, 990
    CLPChilean Peso, 152
    CNYYuan Renminbi, 156
    COPColombian Peso, 170
    COUUnidad de Valor Real, 970
    CRCCosta Rican Colon, 188
    CUCPeso Convertible, 931
    CUPCuban Peso, 192
    CVECabo Verde Escudo, 132
    CZKCzech Koruna, 203
    DJFDjibouti Franc, 262
    DKKDanish Krone, 208
    DOPDominican Peso, 214
    DZDAlgerian Dinar, 12
    EGPEgyptian Pound, 818
    ERNNakfa, 232
    ETBEthiopian Birr, 230
    EUREuro, 978
    FJDFiji Dollar, 242
    FKPFalkland Islands Pound, 238
    GBPPound Sterling, 826
    GELLari, 981
    GHSGhana Cedi, 936
    GIPGibraltar Pound, 292
    GMDDalasi, 270
    GNFGuinean Franc, 324
    GTQQuetzal, 320
    GYDGuyana Dollar, 328
    HKDHong Kong Dollar, 344
    HNLLempira, 340
    HTGGourde, 332
    HUFForint, 348
    IDRRupiah, 360
    ILSNew Israeli Sheqel, 376
    INRIndian Rupee, 356
    IQDIraqi Dinar, 368
    IRRIranian Rial, 364
    ISKIceland Krona, 352
    JMDJamaican Dollar, 388
    JODJordanian Dinar, 400
    JPYYen, 392
    KESKenyan Shilling, 404
    KGSSom, 417
    KHRRiel, 116
    KMFComorian Franc, 174
    KPWNorth Korean Won, 408
    KRWWon, 410
    KWDKuwaiti Dinar, 414
    KYDCayman Islands Dollar, 136
    KZTTenge, 398
    LAKLao Kip, 418
    LBPLebanese Pound, 422
    LKRSri Lanka Rupee, 144
    LRDLiberian Dollar, 430
    LSLLoti, 426
    LYDLibyan Dinar, 434
    MADMoroccan Dirham, 504
    MDLMoldovan Leu, 498
    MGAMalagasy Ariary, 969
    MKDDenar, 807
    MMKKyat, 104
    MNTTugrik, 496
    MOPPataca, 446
    MRUOuguiya, 929
    MURMauritius Rupee, 480
    MVRRufiyaa, 462
    MWKMalawi Kwacha, 454
    MXNMexican Peso, 484
    MXVMexican Unidad de Inversion, 979
    MYRMalaysian Ringgit, 458
    MZNMozambique Metical, 943
    NADNamibia Dollar, 516
    NGNNaira, 566
    NIOCordoba Oro, 558
    NOKNorwegian Krone, 578
    NPRNepalese Rupee, 524
    NZDNew Zealand Dollar, 554
    OMRRial Omani, 512
    PABBalboa, 590
    PENSol, 604
    PGKKina, 598
    PHPPhilippine Peso, 608
    PKRPakistan Rupee, 586
    PLNZloty, 985
    PYGGuarani, 600
    QARQatari Rial, 634
    RONRomanian Leu, 946
    RSDSerbian Dinar, 941
    RUBRussian Ruble, 643
    RWFRwanda Franc, 646
    SARSaudi Riyal, 682
    SBDSolomon Islands Dollar, 90
    SCRSeychelles Rupee, 690
    SDGSudanese Pound, 938
    SEKSwedish Krona, 752
    SGDSingapore Dollar, 702
    SHPSaint Helena Pound, 654
    SLELeone, 925
    SOSSomali Shilling, 706
    SRDSurinam Dollar, 968
    SSPSouth Sudanese Pound, 728
    STNDobra, 930
    SVCEl Salvador Colon, 222
    SYPSyrian Pound, 760
    SZLLilangeni, 748
    THBBaht, 764
    TJSSomoni, 972
    TMTTurkmenistan New Manat, 934
    TNDTunisian Dinar, 788
    TOPPa’anga, 776
    TRYTurkish Lira, 949
    TTDTrinidad and Tobago Dollar, 780
    TWDNew Taiwan Dollar, 901
    TZSTanzanian Shilling, 834
    UAHHryvnia, 980
    UGXUganda Shilling, 800
    USDUS Dollar, 840
    USNUS Dollar (Next day), 997
    UYIUruguay Peso en Unidades Indexadas (UI), 940
    UYUPeso Uruguayo, 858
    UYWUnidad Previsional, 927
    UZSUzbekistan Sum, 860
    VEDBolívar Soberano, 926
    VESBolívar Soberano, 928
    VNDDong, 704
    VUVVatu, 548
    WSTTala, 882
    XAFCFA Franc BEAC, 950
    XAGSilver, 961
    XAUGold, 959
    XBABond Markets Unit European Composite Unit (EURCO), 955
    XBBBond Markets Unit European Monetary Unit (E.M.U.-6), 956
    XBCBond Markets Unit European Unit of Account 9 (E.U.A.-9), 957
    XBDBond Markets Unit European Unit of Account 17 (E.U.A.-17), 958
    XCDEast Caribbean Dollar, 951
    XDRSDR (Special Drawing Right), 960
    XOFCFA Franc BCEAO, 952
    XPDPalladium, 964
    XPFCFP Franc, 953
    XPTPlatinum, 962
    XSUSucre, 994
    XTSCodes specifically reserved for testing purposes, 963
    XUAADB Unit of Account, 965
    XXXThe codes assigned for transactions where no currency is involved, 999
    YERYemeni Rial, 886
    ZARRand, 710
    ZMWZambian Kwacha, 967
    ZWGZimbabwe Gold, 924
    Previous
    Additional fields
    Next
    Bank names
    Built with