localpayment.create() 创建字段后,您可以对返回的对象使用以下方法。
字段类型
以下字段类型可通过create() 方法创建。
事件
使用.on() 方法监听字段实例上的事件,以便对状态变化作出响应。
'change' 事件
当字段值或验证状态发生变化时触发。
回调接收:state(Object)
state.isEmpty(Boolean):如果字段没有值,则为true。state.isValid(Boolean):如果当前值有效,则为true。state.isFocused(Boolean):如果字段当前具有焦点,则为true。state.error(String|undefined):描述验证错误的字符串(如果有)。
'tokenized' 事件
当字段值被 Localpayment 后端成功令牌化后触发。这通常发生在输入有效值且字段失去焦点之后。
例子:
'error' 事件
当发生不可恢复的错误时触发,例如令牌化失败。
回调接收:error(Object)
error.error(String):一条通用错误消息。error.metadata(Object|undefined):有关该错误的其他元数据。
错误处理
SDK 通过error 事件和被拒绝的 promise 提供错误。常见的错误场景包括:
- 网络错误:如果无法发出网络请求,
createSession()将失败。 - 无效凭据:如果
clientCode或apiKey不正确,createSession()将失败。 - 令牌化错误:如果字段值无法令牌化(例如,无效的卡号通过了基本验证,但被处理器拒绝),则会触发 `error 事件。
- 会话过期:如果会话已过期,操作将失败。您必须捕获此错误并通常需要重新创建会话。

