6.1 收款验证（collectionInquiry）（同步）

API由合作伙伴提供，顾客在申请还款时将触发API。

• (1)collectionInquiry是用来验证这笔支付信息是否存在
• (2)collectionInquiry是在取现人去线下店要求收款时实时发生
• (3)取现人需要提供收款码及必要身分验证信息,透过出纳人员或便利商店自动收款机,进行收款验证
• (4)collectionInquiry功能触发点在线下店出纳人员或取现人透过便利商店Kiosk收款机,点选发送collectionInquiry功能要求时,会发送要到SkyPay

• (1)collectionCollect是线下店用来回复已确认完成收款交易时使用
• (2)当出纳人员完成确认后,会实时回传collectionCollect讯息
• (3)功能触发点,在出纳人员,点选collectionCollect,回复收款成功信息给SkyPay服务器

Input parameters

参数	类型	长度	必填	描述
userName	string	50	是	使用者名称 由SkyPay提供 Ex:"userName":"AppName@skypay"
action	string	50	是	调用行为 collectionInquiry(固定参数值) Ex:"action":"collectionInquiry"
authentication	string	255	是	验证密钥 Ex:"authentication":"E1234567-123C-1234-123F-A12345670"
contractNumber	string	13~15	是	收款码 前缀码5码+8~10个数字（前缀码在绑定邮箱中获取） Ex:SKY**12345678
amount	decimal	10.20	是	金额 支付金额支持数字小数位两位 Ex:"amount":3400.00
phone	string	11	是	手机号 08/09开头的11位数字 Ex:"phone":"09270348095"

Post data

{
: ,
: ,
: ,
: ,
: ,
:
}

Output parameters

参数	类型	长度	必填	描述
responseTime	DateTime	50	是	回传时间 yyyy-MM-dd HH:mm:ss.SSSS
responseCode	int	4	是	系统默认回传码,长度为4的数字,标准参考回码定义,系统默认回传码不足时,使用者可自定义代码,请以数字2开头,长度为4的数字,并明确在回传内容
responseDescription	string	255	是	回传内容描述 响应信息
amount	decimal	10.20	是	收款金额 支付金额只能为数字小数位两位监管要求需要还款信息留存档案
payerName	string	255	是	还款人名字 使用逗号分割: "Last name（必填）,First name（必填）,Middle name,Suffix" Ex:"name":"Lardizabal,Mary Annalou B.Lardizabal,Berja,监管要求需要还款信息留存档案
payerAddress	string	255	是	还款人地址 监管要求需要还款信息留存档案
payerPhone	string	11	是	还款人电话 08/08开头11位数字 监管要求需要还款信息留存档案

Output data

{
: ,
: ,
: ,
: ,
: ,
: ,
:
}

Return code:

状态代码	状态描述
1000	Success
-1001	Verification error
-1009	Unpredictable exception occurs
-1015	The contract number is invalid.
-1026	Transactions has been paid