货币单位和金额规范

对于商户而言，UseePay支持的交易币种请以实际签约开通的币种为准。

概要

UseePay处理金额时，以最小辅币为标准单位。即您传给 UseePay 的 amount 需要转换为最小辅币单位值。

例如你的网站使用的货币单位为 USD（美元主币单位）, 商品价格为 12.11美元。
而美元的最小辅币单位是美分，1美分 = 1美元 * 10^(-2)，那么为了满足UseePay最小辅币单位要求，应将包含小数的12.11美元 , 转换为整数1211美分作为商品金额, 传给 UseePay。

UseePay拿到amount=1211和currency=usd之后，会根据币种usd自动识别1211美分，并进行交易处理。

1. 金额单位转换规则

（基于币种最小辅币单位）

1.1 定义

「主单位金额」：指以币种主单位表示的金额（如美元的“元”、迪拉姆的“迪拉姆”），可能包含小数（如9.80美元、1.500迪拉姆）。

「最小辅币单位金额」：指转换为币种最小流通辅币单位的整数金额（如美分、费尔），仅允许整数（如980美分、1500费尔）。

1.2 转换规则
您向UseePay传递的金额，需统一转换为「最小辅币单位金额」，转换逻辑如下：

当币种的最小辅币单位为0.01主单位（即1主单位=100最小辅币单位，如美元、欧元等）：
最小辅币单位金额 = 主单位金额 × 100（结果为整数）。
示例：9.80美元 → 9.80 × 100 = 980美分。

当币种的最小辅币单位为0.001主单位（即1主单位=1000最小辅币单位，如阿联酋迪拉姆、巴林第纳尔等）：
最小辅币单位金额 = 主单位金额 × 1000（结果为整数）。
示例：1.500迪拉姆 → 1.500 × 1000 = 1500费尔。

当币种无辅币单位（即最小单位为1主单位，如日元、韩元等）：
amount 赋值为主单位金额即可（结果为整数）。
（等价于：最小辅币单位金额 = 主单位金额 * 1）
示例：1000日元 → 1000（直接使用主单位金额）。

1.3 执行要求

所有涉及金额的接口，均以「最小辅币单位金额」为准，禁止直接使用带小数的主单位金额。

转换过程中必须关联币种代码（如USD、AED、JPY），通过预设的「币种-最小辅币单位对照表」UseePay会自动匹配转换系数（100/1000/1）。

「币种-最小辅币单位对照表」如下：

2. 币种-最小辅币单位对照表

币种	英文三字码	最小辅币单位10^(-n)
Afghani	AFN	2
Algerian Dinar	DZD	2
Argentine Peso	ARS	2
Armenian Dram	AMD	2
Aruban Florin	AWG	2
Australian Dollar	AUD	2
Azerbaijanian Manat	AZN	2
Bahamian Dollar	BSD	2
Bahraini Dinar	BHD	3
Baht	THB	2
Balboa	PAB	2
Barbados Dollar	BBD	2
Belarusian Ruble	BYN	2
Belize Dollar	BZD	2
Bermudian Dollar	BMD	2
Bolívar	VEF	2
Boliviano	BOB	2
Brazilian Real	BRL	2
Brunei Dollar	BND	2
Bulgarian Lev	BGN	2
Burundi Franc	BIF	0
Cabo Verde Escudo	CVE	2
Canadian Dollar	CAD	2
Cayman Islands Dollar	KYD	2
CFA Franc BCEAO	XOF	0
CFA Franc BEAC	XAF	0
CFP Franc	XPF	0
Chilean Peso	CLP	0
Colombian Peso	COP	2
Comoro Franc	KMF	0
Congolese Franc	CDF	2
Convertible Mark	BAM	2
Cordoba Oro	NIO	2
Costa Rican Colon	CRC	2
Cuban Peso	CUP	2
Czech Koruna	CZK	2
Dalasi	GMD	2
Danish Krone	DKK	2
Denar	MKD	2
Djibouti Franc	DJF	0
Dobra	STD	2
Dominican Peso	DOP	2
Dong	VND	0
East Caribbean Dollar	XCD	2
Egyptian Pound	EGP	2
El Salvador Colon	SVC	2
Ethiopian Birr	ETB	2
Euro	EUR	2
Falkland Islands Pound	FKP	2
Fiji Dollar	FJD	2
Forint	HUF	2
Ghana Cedi	GHS	2
Gibraltar Pound	GIP	2
Gourde	HTG	2
Guarani	PYG	0
Guinea Franc	GNF	0
Guyana Dollar	GYD	2
Hong Kong Dollar	HKD	2
Hryvnia	UAH	2
Iceland Krona	ISK	0
Indian Rupee	INR	2
Iranian Rial	IRR	2
Iraqi Dinar	IQD	3
Jamaican Dollar	JMD	2
Jordanian Dinar	JOD	3
Kenyan Shilling	KES	2
Kina	PGK	2
Kip	LAK	2
Kuna	HRK	2
Kuwaiti Dinar	KWD	3
Kwanza	AOA	2
Kyat	MMK	2
Lari	GEL	2
Lebanese Pound	LBP	2
Lek	ALL	2
Lempira	HNL	2
Leone	SLL	2
Liberian Dollar	LRD	2
Libyan Dinar	LYD	3
Lilangeni	SZL	2
Loti	LSL	2
Malagasy Ariary	MGA	2
Malawi Kwacha	MWK	2
Malaysian Ringgit	MYR	2
Mauritius Rupee	MUR	2
Mexican Peso	MXN	2
Mexican Unidad de Inversion (UDI)	MXV	2
Moldovan Leu	MDL	2
Moroccan Dirham	MAD	2
Mozambique Metical	MZN	2
Mvdol	BOV	2
Naira	NGN	2
Nakfa	ERN	2
Namibia Dollar	NAD	2
Nepalese Rupee	NPR	2
Netherlands Antillean Guilder	ANG	2
New Israeli Sheqel	ILS	2
New Taiwan Dollar	TWD	2
New Zealand Dollar	NZD	2
Ngultrum	BTN	2
North Korean Won	KPW	2
Norwegian Krone	NOK	2
Ouguiya	MRO	2
Pa’anga	TOP	2
Pakistan Rupee	PKR	2
Pataca	MOP	2
Peso Convertible	CUC	2
Peso Uruguayo	UYU	2
Philippine Peso	PHP	2
Pound Sterling	GBP	2
Pula	BWP	2
Qatari Rial	QAR	2
Quetzal	GTQ	2
Rand	ZAR	2
Rial Omani	OMR	3
Riel	KHR	2
Romanian Leu	RON	2
Rufiyaa	MVR	2
Rupiah	IDR	2
Russian Ruble	RUB	2
Rwanda Franc	RWF	0
Saint Helena Pound	SHP	2
Saudi Riyal	SAR	2
Serbian Dinar	RSD	2
Seychelles Rupee	SCR	2
Singapore Dollar	SGD	2
Sol	PEN	2
Solomon Islands Dollar	SBD	2
Som	KGS	2
Somali Shilling	SOS	2
Somoni	TJS	2
South Sudanese Pound	SSP	2
Sri Lanka Rupee	LKR	2
Sudanese Pound	SDG	2
Surinam Dollar	SRD	2
Swedish Krona	SEK	2
Swiss Franc	CHF	2
Syrian Pound	SYP	2
Taka	BDT	2
Tala	WST	2
Tanzanian Shilling	TZS	2
Tenge	KZT	2
Trinidad and Tobago Dollar	TTD	2
Tugrik	MNT	2
Tunisian Dinar	TND	3
Turkish Lira	TRY	2
Turkmenistan New Manat	TMT	2
UAE Dirham	AED	2
Uganda Shilling	UGX	0
Unidad de Fomento	CLF	4
Unidad de Valor Real	COU	2
Uruguay Peso en Unidades Indexadas (URUIURUI)	UYI	0
US Dollar	USD	2
US Dollar (Next day)	USN	2
Uzbekistan Sum	UZS	2
Vatu	VUV	0
WIR Euro	CHE	2
WIR Franc	CHW	2
Won	KRW	0
Yemeni Rial	YER	2
Yen	JPY	0
Yuan Renminbi	CNY	2
Zambian Kwacha	ZMW	2
Zimbabwe Dollar	ZWL	2
Zloty	PLN	2

货币单位和金额规范

1. 金额单位转换规则#

2. 币种-最小辅币单位对照表#

1. 金额单位转换规则

2. 币种-最小辅币单位对照表