处理付款请求​

当买家在结算流程中选中支付应用进行付款时，SHOPLINE 将使用预定的参数协议，对您的支付应用设置的最新的付款URL发起HTTP调用时，并将买家重定向到您返回的PaymentUrl；付款完成后，你需要将买家重定向回接口传递的RedirectUrl,买家将会在RedirectUrl等待最终的支付结果； 您可以用以下两种方式，将支付结果同步到 SHOPLINE：

  1. 提供一个付款查询URL，那么 SHOPLINE 将会在调用付款URL后，已一定的频率通过付款查询URL发起HTTP调用，尝试获取该笔支付的结果，直到获取到终态或者最终超时（一般是24小时）；
  2. 主动调用我们的付款通知Webhook接口，直到返回正确的响应；

支付应用流程的工作原理​

下图说明了支付应用程序和 SHOPLINE 之间的支付流程如何工作：

跳转模式​

image.png

  1. 客户完成结帐，触发付款请求。
  2. SHOPLINE 向支付应用程序发送后端请求，指定要收取的金额和币种。
  3. 该支付应用程序使用合作伙伴应用程序托管的支付页面的重定向 URL 进行响应。
  4. SHOPLINE 将客户重定向到重定向 URL。
  5. 支付应用程序收集客户的支付凭证并按照后端请求中的描述处理支付。
  6. 支付应用程序将支付结果发送到 SHOPLINE，SHOPLINE 将根据需要实施重试策略。
  7. SHOPLINE 使用重定向 URL 进行响应，并发送成功HTTP 状态。
  8. 支付应用程序将客户重定向到 SHOPLINE。
  9. 客户继续结账。

需要注意，支付应用应当使用我们传递的支付单号做幂等处理。

内嵌模式​

image.png

支付状态流转​

对于通过支付应用发起的支付请求，我们期望它的支付状态流转如下： image.png

请求付款接口​

在请求付款时，Shopline将通过Http-Post请求您提供的付款Url；

请求头示例​

对应 Http Request Header

pay-api-version: 1.0.0
pay-api-idempotency-key: TESTKEYKEYKEY
pay-api-signature: SIGNSIGNSIGN
pay-api-timestamp: 1665632758606000
pay-api-store-handle: xxx
字段是否必填含义
pay-api-version是您在配置支付应用拓展时，填入的API VERSION
pay-api-idempotency-key是幂等key
pay-api-signature是签名值
pay-api-timestamp是请求发起时的时间戳
pay-api-store-handle是店铺唯一标识，例如：store1

请求正文示例​

对应 Http Request Body

{
  "orderTransactionId": "test_4ea758952734",
  "referenceOrderId": "test_ff13c864b7fc",
  "amount": 47,
  "currency": "test_6ecc3b427a9f",
  "redirectUrl": "test_a273b5c641b4",
  "cancelUrl": "test_a273b5c6sas",
  "notifyUrl": "test_188f3fe29ae2",
  "billing": {
    "personalInfo": {
      "firstName": "test_fe18d6fc2798",
      "lastName": "test_53fb73557da0",
      "email": "test_e5e3dbd08790",
      "identityType": "test_cac8c5abdbc7",
      "identityNumber": "test_ebc761bb42ac",
      "gender": "test_0704156bc002",
      "phoneNumber": "test_e387bba596a8",
      "homeTelephone": "test_a904ea96f89f",
      "birthDay": "test_dccbf5b55cb6"
    },
    "address": {
      "countryCode": "test_58ee6b67432f",
      "state": "test_c86268fac927",
      "stateCode": "test_bd232ee9b52a",
      "city": "test_a8e72a4b7660",
      "district": "test_60580c478afe",
      "street": "test_f6ca14b11e07",
      "street2": "test_9d168406be68",
      "street3": "test_c9c85ef7c4b6",
      "postcode": "test_7250544bd97d"
    }
  },
  "shipping": {
    "personalInfo": {
      "firstName": "test_4db57f98c782",
      "lastName": "test_d25c9b6d4a07",
      "email": "test_089851321917",
      "identityType": "test_2f2fcc09f376",
      "identityNumber": "test_9b940715498a",
      "gender": "test_5650bb1861d2",
      "phoneNumber": "test_67507bac86dd",
      "homeTelephone": "test_a09b85892bc2",
      "birthDay": "test_9f05f7e481bb"
    },
    "address": {
      "countryCode": "test_096475ce74d7",
      "state": "test_c2113a8b18c9",
      "stateCode": "test_2b8d522f55fa",
      "city": "test_d0a6b9b780ca",
      "district": "test_95a9222ca449",
      "street": "test_a423b3d71c5e",
      "street2": "test_9fb2013867b3",
      "street3": "test_86d526908645",
      "postcode": "test_09ffe0b8cf1b"
    },
    "shippingMethod": "test_7796822bf919",
    "carrier": "test_17327dbfb7ce"
  },
  "products": [
    {
      "id": "test_fb4ef47a1a0f",
      "name": "test_260a61ca16a8",
      "sku": "test_5f883d1deab3",
      "desc": "test_d0cbf7004770",
      "quantity": 38,
      "unitPrice": {
        "value": 54,
        "currency": "test_17c30bdc32b3"
      }
    }
  ],
  "amountBreakdown": {
    "productAmount": 67,
    "discount": 99,
    "productTax": 49,
    "shippingAmount": 10,
    "shippingTax": 5,
    "other": 94
  },
  "merchant": {
    "storeWebsite": "test_b085e7df3518",
    "configData": {}
  },
  "card": {
    "cardNo": "4444444444444444",
    "expirationMonth": "11",
    "expirationYear": "24",
    "cvv": "123",
    "holderName": "test"
  },
  "client": {
    "ip": "test_b556bd9ff25a",
    "deviceType": "test_8baf6c506ef8",
    "deviceId": "test_5a6951dcc93c",
    "javaScriptEnabled": true,
    "javaEnabled": false,
    "colorDepth": "test_8f35331e86f5",
    "screenHeight": "test_e2c2f73f00bf",
    "screenWidth": "test_a0b636ab9ef2",
    "timeZoneOffset": "test_f65b530dfe9c",
    "userAgent": "test_743313c383b4",
    "language": "test_0231f84d3825",
    "transactionWebSite": "test_c991d72e506c",
    "accept": "test_7b30ef6c583c"
  }
}
字段类型是否必填含义
orderTransactionIdstring是支付交易流水号，付款请求唯一标识，系统层面用来交互的单号
referenceOrderIdstring是业务订单号，建议将这个单号展示在您后台的业务单号字段；
用户能通过这个单号，在Shopline后台关联到一笔订单，但这个单号不是Shopline订单号，不能用来查询订单详情；
amountinteger是交易金额
currencystring是交易金额币种
redirectUrlstring是支付完成重定向URL
cancelUrlstring是用户取消支付时的重定向URL
notifyUrlstring是异步结果的通知URL，针对这一笔支付的webhook通知，可以直接请求该链接（路径参数已经包含在链接上了）；
billingobject否账单
|─personalInfoobject是个人信息
  |─firstNamestring否名字
  |─lastNamestring是姓氏
  |─emailstring否邮箱地址
  |─identityTypestring否身份证件类型
  |─identityNumberstring否身份证件号码
  |─genderstring否性别
  |─phoneNumberstring否电话号码
  |─homeTelephonestring否家庭电话号码
  |─birthDaystring否生日,格式为 YYYY-MM-DD
|─addressobject是地址信息
  |─countryCodestring是国家编码
  |─statestring否州/省
  |─stateCodestring否州/省编码
  |─citystring否城市
  |─districtstring否区域
  |─streetstring否街道
  |─street2string否街道2
  |─street3string否街道3
  |─postcodestring否邮政编码
shippingobject否物流
|─personalInfoobject是个人信息
  |─firstNamestring否名字
  |─lastNamestring是姓氏
  |─emailstring否邮箱地址
  |─identityTypestring否身份证件类型
  |─identityNumberstring否身份证件号码
  |─genderstring否性别
  |─phoneNumberstring否电话号码
  |─homeTelephonestring否家庭电话号码
  |─birthDaystring否生日,格式为 YYYY-MM-DD
|─addressobject是地址信息
  |─countryCodestring是国家编码
  |─statestring否州/省
  |─stateCodestring否州/省编码
  |─citystring否城市
  |─districtstring否区域
  |─streetstring否街道
  |─street2string否街道2
  |─street3string否街道3
  |─postcodestring否邮政编码
|─shippingMethodstring是物流方式，如快递送住宅
|─carrierstring否运输渠道,如顺丰、圆通
productsarray是商品列表
|─object
  |─idstring是商品编号
  |─namestring是商品名称
  |─skustring否货号
  |─descstring否描述
  |─quantityinteger是商品数量，非物品item数据为1
  |─unitPriceobject是单价
    |─valueinteger是金额
    |─currencystring是币种
amountBreakdownobject是金额明细
|─productAmountinteger是商品总金额
|─discountinteger是折扣
|─productTaxinteger是商品总税费
|─shippingAmountinteger是物流费
|─shippingTaxinteger是物流税费
|─otherinteger是其它费用
merchantobject是商户信息
|─storeWebsitestring是店铺网站域名
|─configDataobject否商户onboard的信息, 透传给渠道
只有shopline绑定模式下才会传值
cardobject否内嵌模式将会传递
|-cardNostring是卡号
|-expirationMonthstring是有效期月
|-expirationYearstring是有效期年
|-cvvstring是卡片CVV验证码
|-holderNamestring否持卡人姓名
clientobject是客户端信息
|─ipstring是客户端ip
|─deviceTypestring否设备类型
|─deviceIdstring否设备id
|─javaScriptEnabledboolean否浏览器是否支持javascript
|─javaEnabledboolean否浏览器是否支持java
|─colorDepthstring否浏览器显示器色深
|─screenHeightstring否持卡人浏览器分辨率高度
|─screenWidthstring否持卡人浏览器分辨率宽度
|─timeZoneOffsetstring否浏览器本地时区
|─userAgentstring否浏览器 User-Agent
|─languagestring否浏览器语言
|─transactionWebSitestring否交易网址
|─acceptstring否浏览器接受报文类型

响应头示例​

SHOPLINE 必须接收到预期的结果，才会认为当次调用是成功的，如果没有返回预期的结果，那么shopline将认为这次付款请求由于未知的原因失败了，并在结算页面给予用户提示； 对应 Http Responese Header

pay-api-signature: SIGNSIGNSIGN
字段是否必填含义
pay-api-signature是签名值

响应正文示例​

对应 Http Responese Body

{
  "orderTransactionId": "test_6f047f6db6e3",
  "channelOrderTransactionId": "test_0a9991a24e73",
  "paymentUrl": "test_6b84f55b3972",
  "returnCode": "test_6d7c098e15ff",
  "returnMessage": "test_0b9d14bd55c3",
  "returnMessageId": "test_c02c42012682"
}
字段类型是否必填含义
orderTransactionIdstring是支付交易流水号，付款请求唯一标识
channelOrderTransactionIdstring是渠道流水ID，这笔支付在您这边的唯一标识
paymentUrlstring否重定向支付应用的支付页面url
returnCodestring是接口响应状态码
  • SUCCESS: 请求成功

    • 只有返回SUCCESS时，我们才会认为该次请求您已经处理成功；其它值我们都认为该次请求失败；
    returnMessagestring否失败原因
    returnMessageIdstring否渠道响应标识UUID，如 traceId

    针对内嵌模式：

    1. 如果这笔支付需要进行3DS验证，请在paymentUrl返回3DS验证地址，我们将会将买家重定向到该页面；
    2. 如果不需要3DS验证，请在paymentUrl返回入参传递的redirectUrl，买家将会在这个页面等待支付结果；

    同步付款结果​

    在客户成功完成付款流程后，您可以通过以下两种方式，将付款结果同步给Shopline，其中付款查询能力是必需的，当然Shopline建议您两种方式同时提供：

    1. 提供一个付款查询URL，那么Shopline将会在调用付款URL后，以一定的频率通过付款查询URL发起HTTP调用，尝试获取该笔支付的结果，直到获取到终态或者最终超时（一般是24小时）；
    2. 主动调用我们的付款通知Webhook接口，直到返回正确的响应（我们会在回调逻辑中，请求付款查询URL以获取支付状态）；

    付款查询请求头示例​

    对应 Http Request Header

    pay-api-version: 1.0.0
    pay-api-idempotency-key: TESTKEYKEYKEY
    pay-api-signature: SIGNSIGNSIGN
    pay-api-timestamp: 1665632758606000
    字段是否必填含义
    pay-api-version是您在配置支付应用拓展时，填入的API VERSION
    pay-api-idempotency-key是幂等key
    pay-api-signature是签名值
    pay-api-timestamp是请求发起时的时间戳

    付款查询请求参数示例​

    对应 Http Request Query

    orderTransactionId = SLASDJK12312131
    字段是否必填含义
    orderTransactionId是支付交易流水号，付款请求唯一标识

    付款查询响应头示例​

    对应 Http Response Header

    pay-api-signature: SIGNSIGNSIGN
    字段是否必填含义
    pay-api-signature是签名值

    付款查询响应正文示例​

    对应 Http Response Header Body

    字段类型是否必填含义
    orderTransactionIdstring是支付交易流水号，付款请求唯一标识
    channelOrderTransactionIdstring是渠道流水
    paymentStatusstring是支付状态
  • PROCESSING: 处理中
  • SUCCEEDED: 已完成支付
  • FAILED: 支付失败
  • CANCELLED: 已取消支付
  • EXPIRED: 已过期

    • 支付状态流转及枚举
    amountinteger是交易金额
    currencystring是交易金额币种
    failCodestring否失败错误码
    failMessagestring否失败原因
    returnCodestring是接口响应状态码
  • SUCCESS: 请求成功

    • 只有返回SUCCESS时，我们才会认为该次请求您已经处理成功；其它值我们都认为该次请求失败；
    returnMessagestring否失败原因
    returnMessageIdstring否渠道响应标识UUID，如 traceId

    主动通知Shopline支付结果​

    您可以通过调用付款结果通知的OpenApi接口，来主动通知Shopline支付结果；Shopline在接收到通知后，会通过付款查询接口，来获取支付结果，不会直接信任通知结果；

    附录​

    《国家地区编码》​

    国家地区编码使用ISO 3166国际标准。

    中文名称英文短名称二位代码地区编码ISO 3166-2
    阿富汗AfghanistanAFISO 3166-2
    奥兰Åland IslandsAXISO 3166-2
    阿尔巴尼亚AlbaniaALISO 3166-2
    阿尔及利亚AlgeriaDZISO 3166-2
    美属萨摩亚American SamoaASISO 3166-2
    安道尔AndorraADISO 3166-2
    安哥拉AngolaAOISO 3166-2
    安圭拉AnguillaAIISO 3166-2
    南极洲AntarcticaAQISO 3166-2
    安提瓜和巴布达Antigua and BarbudaAGISO 3166-2
    阿根廷ArgentinaARISO 3166-2
    亚美尼亚ArmeniaAMISO 3166-2
    阿鲁巴ArubaAWISO 3166-2
    澳大利亚AustraliaAUISO 3166-2
    奥地利AustriaATISO 3166-2
    阿塞拜疆AzerbaijanAZISO 3166-2
    巴哈马BahamasBSISO 3166-2
    巴林BahrainBHISO 3166-2
    孟加拉国BangladeshBDISO 3166-2
    巴巴多斯BarbadosBBISO 3166-2
    白俄罗斯BelarusBYISO 3166-2
    比利时BelgiumBEISO 3166-2
    伯利兹BelizeBZISO 3166-2
    贝宁BeninBJISO 3166-2
    百慕大BermudaBMISO 3166-2
    不丹BhutanBTISO 3166-2
    玻利维亚Bolivia (Plurinational State of)BOISO 3166-2
    荷兰加勒比区Bonaire, Sint Eustatius and SabaBQISO 3166-2
    波黑Bosnia and HerzegovinaBAISO 3166-2
    博茨瓦纳BotswanaBWISO 3166-2
    布韦岛Bouvet IslandBVISO 3166-2
    巴西BrazilBRISO 3166-2
    英属印度洋领地British Indian Ocean TerritoryIOISO 3166-2
    文莱Brunei DarussalamBNISO 3166-2
    保加利亚BulgariaBGISO 3166-2
    布基纳法索Burkina FasoBFISO 3166-2
    布隆迪BurundiBIISO 3166-2
    佛得角Cabo VerdeCVISO 3166-2
    柬埔寨CambodiaKHISO 3166-2
    喀麦隆CameroonCMISO 3166-2
    加拿大CanadaCAISO 3166-2
    开曼群岛Cayman IslandsKYISO 3166-2
    中非Central African RepublicCFISO 3166-2
    乍得ChadTDISO 3166-2
    智利ChileCLISO 3166-2
    中国ChinaCNISO 3166-2
    圣诞岛Christmas IslandCXISO 3166-2
    科科斯（基林）群岛Cocos (Keeling) IslandsCCISO 3166-2
    哥伦比亚ColombiaCOISO 3166-2
    科摩罗ComorosKMISO 3166-2
    刚果共和国CongoCGISO 3166-2
    刚果民主共和国Congo (Democratic Republic of the)CDISO 3166-2
    库克群岛Cook IslandsCKISO 3166-2
    哥斯达黎加Costa RicaCRISO 3166-2
    科特迪瓦Côte d'IvoireCIISO 3166-2
    克罗地亚CroatiaHRISO 3166-2
    古巴CubaCUISO 3166-2
    库拉索CuraçaoCWISO 3166-2
    塞浦路斯CyprusCYISO 3166-2
    捷克CzechiaCZISO 3166-2
    丹麦DenmarkDKISO 3166-2
    吉布提DjiboutiDJISO 3166-2
    多米尼克DominicaDMISO 3166-2
    多米尼加Dominican RepublicDOISO 3166-2
    厄瓜多尔EcuadorECISO 3166-2
    埃及EgyptEGISO 3166-2
    萨尔瓦多El SalvadorSVISO 3166-2
    赤道几内亚Equatorial GuineaGQISO 3166-2
    厄立特里亚EritreaERISO 3166-2
    爱沙尼亚EstoniaEEISO 3166-2
    斯威士兰EswatiniSZISO 3166-2
    埃塞俄比亚EthiopiaETISO 3166-2
    福克兰群岛Falkland Islands (Malvinas)FKISO 3166-2
    法罗群岛Faroe IslandsFOISO 3166-2
    斐济FijiFJISO 3166-2
    芬兰FinlandFIISO 3166-2
    法国FranceFRISO 3166-2
    法属圭亚那French GuianaGFISO 3166-2
    法属波利尼西亚French PolynesiaPFISO 3166-2
    法属南部和南极领地French Southern TerritoriesTFISO 3166-2
    加蓬GabonGAISO 3166-2
    冈比亚GambiaGMISO 3166-2
    格鲁吉亚GeorgiaGEISO 3166-2
    德国GermanyDEISO 3166-2
    加纳GhanaGHISO 3166-2
    直布罗陀GibraltarGIISO 3166-2
    希腊GreeceGRISO 3166-2
    格陵兰GreenlandGLISO 3166-2
    格林纳达GrenadaGDISO 3166-2
    瓜德罗普GuadeloupeGPISO 3166-2
    关岛GuamGUISO 3166-2
    危地马拉GuatemalaGTISO 3166-2
    根西GuernseyGGISO 3166-2
    几内亚GuineaGNISO 3166-2
    几内亚比绍Guinea-BissauGWISO 3166-2
    圭亚那GuyanaGYISO 3166-2
    海地HaitiHTISO 3166-2
    赫德岛和麦克唐纳群岛Heard Island and McDonald IslandsHMISO 3166-2
    梵蒂冈Holy SeeVAISO 3166-2
    洪都拉斯HondurasHNISO 3166-2
    香港Hong KongHKISO 3166-2
    匈牙利HungaryHUISO 3166-2
    冰岛IcelandISISO 3166-2
    印度IndiaINISO 3166-2
    印尼IndonesiaIDISO 3166-2
    伊朗Iran (Islamic Republic of)IRISO 3166-2
    伊拉克IraqIQISO 3166-2
    爱尔兰IrelandIEISO 3166-2
    马恩岛Isle of ManIMISO 3166-2
    以色列IsraelILISO 3166-2
    意大利ItalyITISO 3166-2
    牙买加JamaicaJMISO 3166-2
    日本JapanJPISO 3166-2
    泽西JerseyJEISO 3166-2
    约旦JordanJOISO 3166-2
    哈萨克斯坦KazakhstanKZISO 3166-2
    肯尼亚KenyaKEISO 3166-2
    基里巴斯KiribatiKIISO 3166-2
    朝鲜Korea (Democratic People's Republic of)KPISO 3166-2
    韩国Korea (Republic of)KRISO 3166-2
    科威特KuwaitKWISO 3166-2
    吉尔吉斯斯坦KyrgyzstanKGISO 3166-2
    老挝Lao People's Democratic RepublicLAISO 3166-2
    拉脱维亚LatviaLVISO 3166-2
    黎巴嫩LebanonLBISO 3166-2
    莱索托LesothoLSISO 3166-2
    利比里亚LiberiaLRISO 3166-2
    利比亚LibyaLYISO 3166-2
    列支敦士登LiechtensteinLIISO 3166-2
    立陶宛LithuaniaLTISO 3166-2
    卢森堡LuxembourgLUISO 3166-2
    澳门MacaoMOISO 3166-2
    马达加斯加MadagascarMGISO 3166-2
    马拉维MalawiMWISO 3166-2
    马来西亚MalaysiaMYISO 3166-2
    马尔代夫MaldivesMVISO 3166-2
    马里MaliMLISO 3166-2
    马耳他MaltaMTISO 3166-2
    马绍尔群岛Marshall IslandsMHISO 3166-2
    马提尼克MartiniqueMQISO 3166-2
    毛里塔尼亚MauritaniaMRISO 3166-2
    毛里求斯MauritiusMUISO 3166-2
    马约特MayotteYTISO 3166-2
    墨西哥MexicoMXISO 3166-2
    密克罗尼西亚联邦Micronesia (Federated States of)FMISO 3166-2
    摩尔多瓦Moldova (Republic of)MDISO 3166-2
    摩纳哥MonacoMCISO 3166-2
    蒙古MongoliaMNISO 3166-2
    黑山MontenegroMEISO 3166-2
    蒙特塞拉特MontserratMSISO 3166-2
    摩洛哥MoroccoMAISO 3166-2
    莫桑比克MozambiqueMZISO 3166-2
    缅甸MyanmarMMISO 3166-2
    纳米比亚NamibiaNAISO 3166-2
    瑙鲁NauruNRISO 3166-2
    尼泊尔NepalNPISO 3166-2
    荷兰NetherlandsNLISO 3166-2
    新喀里多尼亚New CaledoniaNCISO 3166-2
    新西兰New ZealandNZISO 3166-2
    尼加拉瓜NicaraguaNIISO 3166-2
    尼日尔NigerNEISO 3166-2
    尼日利亚NigeriaNGISO 3166-2
    纽埃NiueNUISO 3166-2
    诺福克岛Norfolk IslandNFISO 3166-2
    北马其顿North MacedoniaMKISO 3166-2
    北马里亚纳群岛Northern Mariana IslandsMPISO 3166-2
    挪威NorwayNOISO 3166-2
    阿曼OmanOMISO 3166-2
    巴基斯坦PakistanPKISO 3166-2
    帕劳PalauPWISO 3166-2
    巴勒斯坦Palestine, State ofPSISO 3166-2
    巴拿马PanamaPAISO 3166-2
    巴布亚新几内亚Papua New GuineaPGISO 3166-2
    巴拉圭ParaguayPYISO 3166-2
    秘鲁PeruPEISO 3166-2
    菲律宾PhilippinesPHISO 3166-2
    皮特凯恩群岛PitcairnPNISO 3166-2
    波兰PolandPLISO 3166-2
    葡萄牙PortugalPTISO 3166-2
    波多黎各Puerto RicoPRISO 3166-2
    卡塔尔QatarQAISO 3166-2
    留尼汪RéunionREISO 3166-2
    罗马尼亚RomaniaROISO 3166-2
    俄罗斯Russian FederationRUISO 3166-2
    卢旺达RwandaRWISO 3166-2
    圣巴泰勒米Saint BarthélemyBLISO 3166-2
    圣赫勒拿、阿森松和特里斯坦-达库尼亚Saint Helena, Ascension and Tristan da CunhaSHISO 3166-2
    圣基茨和尼维斯Saint Kitts and NevisKNISO 3166-2
    圣卢西亚Saint LuciaLCISO 3166-2
    法属圣马丁Saint Martin (French part)MFISO 3166-2
    圣皮埃尔和密克隆Saint Pierre and MiquelonPMISO 3166-2
    圣文森特和格林纳丁斯Saint Vincent and the GrenadinesVCISO 3166-2
    萨摩亚SamoaWSISO 3166-2
    圣马力诺San MarinoSMISO 3166-2
    圣多美和普林西比Sao Tome and PrincipeSTISO 3166-2
    沙特阿拉伯Saudi ArabiaSAISO 3166-2
    塞内加尔SenegalSNISO 3166-2
    塞尔维亚SerbiaRSISO 3166-2
    塞舌尔SeychellesSCISO 3166-2
    塞拉利昂Sierra LeoneSLISO 3166-2
    新加坡SingaporeSGISO 3166-2
    荷属圣马丁Sint Maarten (Dutch part)SXISO 3166-2
    斯洛伐克SlovakiaSKISO 3166-2
    斯洛文尼亚SloveniaSIISO 3166-2
    所罗门群岛Solomon IslandsSBISO 3166-2
    索马里SomaliaSOISO 3166-2
    南非South AfricaZAISO 3166-2
    南乔治亚和南桑威奇群岛South Georgia and the South Sandwich IslandsGSISO 3166-2
    南苏丹South SudanSSISO 3166-2
    西班牙SpainESISO 3166-2
    斯里兰卡Sri LankaLKISO 3166-2
    苏丹SudanSDISO 3166-2
    苏里南SurinameSRISO 3166-2
    斯瓦尔巴和扬马延Svalbard and Jan MayenSJISO 3166-2
    瑞典SwedenSEISO 3166-2
    瑞士SwitzerlandCHISO 3166-2
    叙利亚Syrian Arab RepublicSYISO 3166-2
    中国台湾省Taiwan, Province of ChinaTWISO 3166-2
    塔吉克斯坦TajikistanTJISO 3166-2
    坦桑尼亚Tanzania, United Republic ofTZISO 3166-2
    泰国ThailandTHISO 3166-2
    东帝汶Timor-LesteTLISO 3166-2
    多哥TogoTGISO 3166-2
    托克劳TokelauTKISO 3166-2
    汤加TongaTOISO 3166-2
    特立尼达和多巴哥Trinidad and TobagoTTISO 3166-2
    突尼斯TunisiaTNISO 3166-2
    土耳其TurkeyTRISO 3166-2
    土库曼斯坦TurkmenistanTMISO 3166-2
    特克斯和凯科斯群岛Turks and Caicos IslandsTCISO 3166-2
    图瓦卢TuvaluTVISO 3166-2
    乌干达UgandaUGISO 3166-2
    乌克兰UkraineUAISO 3166-2
    阿联酋United Arab EmiratesAEISO 3166-2
    英国United Kingdom of Great Britain and Northern IrelandGBISO 3166-2
    美国United States of AmericaUSISO 3166-2
    美国本土外小岛屿United States Minor Outlying IslandsUMISO 3166-2
    乌拉圭UruguayUYISO 3166-2
    乌兹别克斯坦UzbekistanUZISO 3166-2
    瓦努阿图VanuatuVUISO 3166-2
    委内瑞拉Venezuela (Bolivarian Republic of)VEISO 3166-2
    越南Viet NamVNISO 3166-2
    英属维尔京群岛Virgin Islands (British)VGISO 3166-2
    美属维尔京群岛Virgin Islands (U.S.)VIISO 3166-2
    瓦利斯和富图纳Wallis and FutunaWFISO 3166-2
    西撒哈拉Western SaharaEHISO 3166-2
    也门YemenYEISO 3166-2
    赞比亚ZambiaZMISO 3166-2
    津巴布韦ZimbabweZWISO 3166-2

    《币种及精度定义》​

    CountryCurrency NameCurrency Code币种精度最小支付金额金额传参
    United Arab EmiratesUAE DirhamAED2位小数0.1x100
    AfghanistanAfghan AfghaniAFN2位小数0.1x100
    ArmeniaArmenian DramAMD2位小数0.1x100
    Curaçao and Sint MaartenNetherlands Antillian GuilderANG2位小数0.1x100
    AngolaKwanzaAOA2位小数0.1x100
    ArgentinaArgentine PesoARS2位小数0.1x100
    AustraliaAustralian DollarAUD2位小数0.1x100
    ArubaAruban FlorinAWG2位小数0.1x100
    AzerbaijanAzerbaijanian ManatAZN2位小数0.1x100
    AlbaniaLekALL2位小数0.1x100
    Bosnia and HerzegovinaConvertible MarksBAM2位小数0.1x100
    BarbadosBarbados DollarBBD2位小数0.1x100
    People's Republic of BangladeshTakaBDT2位小数0.1x100
    BulgariaBulgarian LevBGN2位小数0.1x100
    BahrainBahraini DinarBHD3位小数0.1x 1000，且最后一位必须为零
    BurundiBurundi FrancBIF整数1x 1，全位整数
    BermudaBermudian DollarBMD2位小数0.1x100
    BruneiBrunei DollarBND2位小数0.1x100
    BoliviaBolivianoBOB2位小数0.1x100
    BrazilBrazilian RealBRL2位小数0.1x100
    BahamasBahamian DollarBSD2位小数0.1x100
    Kingdom of BhutanNgultrumBTN2位小数0.1x100
    BotswanaPulaBWP2位小数0.1x100
    BelarusBelarussian RubleBYN2位小数0.1x100
    BelizeBelize DollarBZD2位小数0.1x100
    CanadaCanadian DollarCAD2位小数0.1x100
    Democratic Republic of the CongoCongolese FranceCDF2位小数0.1x100
    Switzerland and LiechtensteinSwiss FrancCHF2位小数0.1x100
    ChileUnidad de FomentoCLF整数1x 1，全位整数
    ChileChilean PesoCLP2位小数0.1x100，且最后两位必须为0
    People's Republic of ChinaYuan RenminbiCNY2位小数0.1x100
    ColombiaColombian PesoCOP2位小数0.1x100
    Costa RicaCosta Rican ColonCRC2位小数0.1x100
    CubaCuban PesoCUP2位小数0.1x100
    CubaCuban Convertible PesoCUC2位小数0.1x100
    Cape VerdeCape Verde EscudoCVE2位小数0.1x100
    Czech RepublicCzech KorunaCZK2位小数0.1x100
    DjiboutiDjibouti FrancDJF整数1x 1，全位整数
    DenmarkDanish KroneDKK2位小数0.1x100
    Dominican RepublicDominican PesoDOP2位小数0.1x100
    AlgeriaAlgerian DinarDZD2位小数0.1x100
    EstoniaKroonEEK2位小数0.1x100
    EgyptEgyptian PoundEGP2位小数0.1x100
    EritreaNakfaERN2位小数0.1x100
    EthiopiaEthiopian BirrETB2位小数0.1x100
    EurozoneEuroEUR2位小数0.1x100
    FijiFiji DollarFJD2位小数0.1x100
    Falkland IslandsFalkland Islands PoundFKP2位小数0.1x100
    United Kingdom, Jersey, Guernsey, the Isle of Man, South Georgia and the South Sandwich Islands, the British Antarctic Territory, Tristan da CunhaPound SterlingGBP2位小数0.1x100
    GeorgiaLariGEL2位小数0.1x100
    GhanaCediGHS2位小数0.1x100
    GibraltarGibraltar PoundGIP2位小数0.1x100
    GambiaDalasiGMD2位小数0.1x100
    GuineaGuinea FrancGNF整数1x 1，全位整数
    GuatemalaQuetzalGTQ2位小数0.1x100
    GuyanaGuyana DollarGYD2位小数0.1x100
    Hong KongHong Kong DollarHKD2位小数0.1x100
    HondurasLempiraHNL2位小数0.1x100
    CroatiaCroatian KunaHRK2位小数0.1x100
    HaitiGourdeHTG2位小数0.1x100
    HungaryForintHUF2位小数0.1x100
    IndonesiaRupiahIDR2位小数0.1x100
    IsraelNew Israeli SheqelILS2位小数0.1x100
    IndiaIndian RupeeINR2位小数0.1x100
    IraqIraqi DinarIQD3位小数0.1x 1000，且最后一位必须为零
    IranIranian RialIRR2位小数0.1x100
    IcelandIceland KronaISK整数1x 1，全位整数
    JamaicaJamaican DollarJMD2位小数0.1x100
    JordanJordanian DinarJOD3位小数0.1x 1000，且最后一位必须为零
    JapanYenJPY整数1x 1，全位整数
    KenyaKenyan ShillingKES2位小数0.1x100
    Kyrgyz RepublicSomKGS2位小数0.1x100
    CambodiaRielKHR2位小数0.1x100
    ComorosComoro FrancKMF整数1x 1，全位整数
    North KoreaNorth Korean WonKPW2位小数0.1x100
    South KoreaWonKRW整数1x 1，全位整数
    KuwaitKuwaiti DinarKWD3位小数0.1x 1000，且最后一位必须为零
    Cayman IslandsCayman Islands DollarKYD2位小数0.1x100
    KazakhstanTengeKZT2位小数0.1x100
    LaosKipLAK2位小数0.1x100
    LebanonLebanese PoundLBP2位小数0.1x100
    Sri LankaSri Lanka RupeeLKR2位小数0.1x100
    LiberiaLiberian DollarLRD2位小数0.1x100
    LesothoLotiLSL2位小数0.1x100
    LithuaniaLithuanian LitasLTL2位小数0.1x100
    LatviaLatvian LatsLVL2位小数0.1x100
    LibyaLibyan DinarLYD3位小数0.1x 1000，且最后一位必须为零
    MoroccoMoroccan DirhamMAD2位小数0.1x100
    MoldovaMoldovan LeuMDL2位小数0.1x100
    MadagascarMalagasy AriaryMGA2位小数0.1x100
    North MacedoniaDenarMKD2位小数0.1x100
    MyanmarKyatMMK2位小数0.1x100
    MongoliaTugrikMNT2位小数0.1x100
    MacauPatacaMOP2位小数0.1x100
    MauritaniaOuguiyaMRU2位小数0.1x100
    MauritiusMauritius RupeeMUR2位小数0.1x100
    MaldivesRufiyaaMVR2位小数0.1x100
    MalawiKwachaMWK2位小数0.1x100
    MexicoMexican PesoMXN2位小数0.1x100
    MexicoMexican Unidad de InversionMXV2位小数0.1x100
    MalaysiaMalaysian RinggitMYR2位小数0.1x100
    MozambiqueMeticalMZN2位小数0.1x100
    NamibiaNamibia DollarNAD2位小数0.1x100
    NigeriaNairaNGN2位小数0.1x100
    NicaraguaCordoba OroNIO2位小数0.1x100
    NorwayNorwegian KroneNOK2位小数0.1x100
    NepalNepalese RupeeNPR2位小数0.1x100
    New ZealandNew Zealand DollarNZD2位小数0.1x100
    OmanRial OmaniOMR3位小数0.1x 1000，且最后一位必须为零
    PanamaBalboaPAB2位小数0.1x100
    PeruNuevo SolPEN2位小数0.1x100
    Papua New GuineaKinaPGK2位小数0.1x100
    PhilippinesPhilippine PesoPHP2位小数0.1x100
    PakistanPakistan RupeePKR2位小数0.1x100
    PolandZlotyPLN2位小数0.1x100
    ParaguayGuaraniPYG整数1x 1，全位整数
    State of QatarQatari RialQAR2位小数0.1x100
    RomaniaNew LeyRON2位小数0.1x100
    SerbiaNew Serbian DinarRSD2位小数0.1x100
    RussiaRussian RubleRUB2位小数0.1x100
    RwandaRwanda FrancRWF整数1x 1，全位整数
    Saudi ArabiaSaudi RiyalSAR2位小数0.1x100
    Solomon IslandsSolomon Islans DollarSBD2位小数0.1x100
    SeychellesSeychelles RupeeSCR2位小数0.1x100
    Republic of the SudanNew Sudanese PoundSDG2位小数0.1x100
    Republic of South SudanSouth Sudanese poundSSP2位小数0.1x100
    SwedenSwedish KronaSEK2位小数0.1x100
    SingaporeSingapore DollarSGD2位小数0.1x100
    Saint Helena and AscensionSaint Helena PoundSHP2位小数0.1x100
    Sierra LeoneLeoneSLL2位小数0.1x100
    SomaliaSomali ShillingSOS2位小数0.1x100
    SurinameSurinamese DollarSRD2位小数0.1x100
    São Tomé and PríncipeDobraSTN2位小数0.1x100
    El SalvadorEl Salvador ColonSVC2位小数0.1x100
    SyriaSyrian PoundSYP2位小数0.1x100
    EswatiniLilangeniSZL2位小数0.1x100
    ThailandBahtTHB2位小数0.1x100
    TajikistanSomoniTJS2位小数0.1x100
    TurkmenistanManatTMT2位小数0.1x100
    TunisiaTunisian DinarTND3位小数0.1x 1000，且最后一位必须为零
    TongaPaangaTOP2位小数0.1x100
    TurkeyTurkish LiraTRY2位小数0.1x100
    Trinidad and TobagoTrinidad and Tobago DollarTTD2位小数0.1x100
    Republic of China (Taiwan)New Taiwan DollarTWD2位小数0.1x100
    TanzaniaTanzanian ShillingTZS2位小数0.1x100
    UkraineHryvniaUAH2位小数0.1x100
    UgandaUganda ShillingUGX整数1x 1，全位整数
    United StatesUS DollarUSD2位小数0.1x100
    UruguayPeso UruguayoUYU2位小数0.1x100
    UzbekistanUzbekistan SumUZS2位小数0.1x100
    BolivarBolivar FuerteVES2位小数0.1x100
    BolivarVenezuela Bolivar FuerteVEF2位小数0.1x100
    VietnamDongVND整数1x 1，全位整数
    VanuatuVatuVUV整数1x 1，全位整数
    SamoaTalaWST2位小数0.1x100
    Cameroon, Central African Republic, Chad, Republic of the Congo, Equatorial Guinea, GabonCFA Franc BEACXAF整数1x 1，全位整数
    East CaribbeanEast Caribbean DollarXCD2位小数0.1x100
    Benin, Burkina Faso, Guinea-Bissau, Ivory Coast, Mali, Niger, Senegal, TogoCFA Franc BCEAOXOF整数1x 1，全位整数
    French Polynesia, New Caledonia, Wallis and FutunaCFP FrancXPF整数1x 1，全位整数
    YemenYemeni RialYER2位小数0.1x100
    South AfricaRandZAR2位小数0.1x100
    ZambiaZambian KwachaZMW2位小数0.1x100
    ZimbabweZimbabwe DollarZWL2位小数0.1x100
    这篇文章对你有帮助吗？
    SHOPLINE
    SHOPLINE
    SHOPLINE Enterprise
    条款协议
    隐私
    条款
    开发者协议
    LinkedInEmail
    LinkedInEmail
    © Copyright 2013-2025 SHOPLINE Limited.