createComponent()

2026-07-10 10:40

createComponent() is called by merchant applications to create and display payment or card binding component UIs.

Notes:
This method must be called after init() .
This method is mutually exclusive with confirmPayment() .
In the Payment Element scenario, paymentSessionData must be obtained from the server's createPaymentSession (One-time Payments) API response.
In the Vaulting Element scenario, vaultingSessionData must be obtained from the server's createVaultingSession API response.

Method signature

Payment Element scenario

Vaulting Element scenario

copy
Future<void> createComponent(
  String paymentSessionData,
  void Function(AMSStatusResult) onResult,
)

Parameters

Parameter	Data type	Is required?	Description
paymentSessionData	String	Yes	Payment session data. Pass the complete paymentSessionData value obtained from the createPaymentSession (One-time Payments) API response into this parameter. Notes: In the Payment Element scenario, this parameter is required. Either this parameter or vaultSessionData must be provided.
vaultSessionData	String	Yes	Vaulting session data. Pass the complete vaultingSessionData value obtained from the createVaultingSession API response into this parameter. Notes: In the Vaulting Element scenario, this parameter is required. Either this parameter or paymentSessionData must be provided.
onResult	Function	Yes	Initialization result callback function. Used to return the result of successful or failed initialization. Refer to `onResult` for details.

onResult

The result callback from the createComponent() method receives an AMSStatusResult object indicating whether the initialization was successful.

Parameter	Data type	Is required?	Description
result	AMSStatusResult	Yes	Status results containing initialization status and error details.

Return value

This method returns no value, and the initialization result is returned asynchronously through the onResult callback.

Error codes

Error messages are returned via AMSStatusResult in the onResult callback. When getStatus() returns FAIL , you can obtain error details through getError().

Payment Element scenario

Vaulting Element scenario

code	status	Suggested prompt to the buyer (message)	Description	Further action
`INQUIRY_PAYMENT_SESSION_FAILED`	`FAIL`	The order status is abnormal. Please check the payment status and contact the merchant.	The payment session has expired.	The order has timed out and been closed. Use a new paymentRequestId to initiate the payment again.
`PARAM_INVALID`	N/A	An error occurred. The transaction cannot be initiated.	SDK input parameters are abnormal.	Integration code exception. Troubleshoot yourself required. If the problem persists, contact Antom Technical Support.
`UI_STATE_ERROR`	N/A	An error occurred. The transaction cannot be initiated.	Abnormal timing when creating SDK instances or `createComponent()`.	Integration code exception. Troubleshoot yourself required. If the problem persists, contact Antom Technical Support.
`INITIALIZE_WEB_TIMEOUT`	N/A	An error occurred. The transaction cannot be initiated.	The checkout page static resource loading had timed out.	Buyer network exception or Antom service exception detected. Retry the `createComponent()` method.

code	status	Suggested prompt for buyers (message)	Description	Recommended action
`PARAM_INVALID`	N/A	Request exception, transaction cannot be initiated.	The SDK input parameters are invalid.	Check your integration code. If the issue persists, contact Antom Technical Support.
`UI_STATE_ERROR`	`FAIL`	Request exception, transaction cannot be initiated.	The API was called at an invalid time or in an invalid state.	Check your integration code. If the issue persists, contact Antom Technical Support.
`INITIALIZE_WEB_TIMEOUT`	N/A	Request exception, transaction cannot be initiated.	The checkout static resources failed to load within the timeout period.	The issue may be caused by the user's network or an Antom service exception. Retry the operation.