setOnSubmitPayListener()

setOnSubmitPayListener()
is called by merchant applications to register a callback listener for payment or card binding submission status. This callback is triggered when a buyer initiates payment or card binding requests in the payment or card binding component UI (for example, by clicking the payment or card binding button).

Method signature

Future<void> setOnSubmitPayListener(
void Function(AMSStatusResult result) onSubmitPayCallback,
)

Parameters

onSubmitPayCallback

Payment or card binding submission callback function that receives an
AMSStatusResult
object containing the submission status.

Return value

Return
Future<void>
to indicate that the listener registration submission for payment or card binding has been completed. The result of a payment or card binding submission is not returned by this return value, but by an asynchronous callback notification via
onSubmitPayCallback
.

Error codes

Error messages are returned via
AMSStatusResult
in the
onSubmitPayCallback
callback.
Payment Element scenario
Payment Element saved‑card scenario
Vaulting Element scenario