Appendix: Quick Reference Tables
The NMI Payment Device SDK provides asynchronous callbacks to handle device updates, transaction flow, and error handling. Below is a categorized reference.
| Callback | Purpose | Next Action |
|---|---|---|
onAvailablePinPads | Returns available readers | Select device & connect |
onConnectAndConfigureFinished | Ready to transact | Start transaction |
onTransactionUpdate | EMV progress updates | Update UI |
onTransactionFinished | Transaction complete | Confirm/Void |
onSignatureVerification | Signature required | Call continueSignatureVerification() |
onDeferredAuthorization | Offline fallback possible | Call continueDeferredAuthorization() |
onProcessReceiptFinished | Receipt delivered | Log result |
The following optional startTransaction() parameters store a card for later use. See Payment Methods for details.
| Parameter | Values | Used for |
|---|---|---|
CustomerVaultCommand | add-customer, update-customer | Customer Vault |
CustomerVaultId | Vault record ID, up to 199 characters | Customer Vault |
CredentialOnFileFirstStore | TRUE | Credential on File, Incremental Authorization |
CredentialOnFileReason | A reason, such as ReasonUnscheduled | Credential on File; ReasonIncremental for Incremental Authorization |
On iOS, the parameter keys are prefixed CCParam (for example CCParamCustomerVaultCommand) and the reason values CCValue (for example CCValueReasonIncremental).
Updated 3 days ago
Did this page help you?
