Angular Installation

Amwal Checkout Button

To set up your website to use Amwal checkout button, follow the following steps:


Sign up with amwal merchant for your country. for KSA, visit to obtain a sandbox key or production key


npm i amwal-checkout-angular


  1. In your component.module.ts file, import amwal module:
// component.module.ts
import { AmwalCheckoutButtonModule } from "amwal-checkout-angular/dist/amwal-checkout-button";
  declarations: [
  imports: [
  exports: [
  providers: [
export class ComponentModule { }

  1. In your component.component.html:
  shippingMethods='[{"id": "free-shipping","label": "3 days free shipping","price": 0},{"id": "express-shipping","label": "1 day delivery","price": 10}]' 
  1. Handling shipping value change to complete address handshake:
  paymentSuccessful(event: any) {
    console.log('Payment successful:', event);
    // Handle payment success (e.g., update your order status)

  addressHandler(event: any) {
    console.log('Address updated:', event);
    // Handle address update
    setTimeout(() => window.dispatchEvent(new Event('amwalAddressAck')), 1000);


addressHandshakeaddress-handshakeaddressHandshake specifies if address event and ack is activated ("true" or "false")booleanfalse
addressRequiredaddress-requiredaddressRequired specifies if shipping address is required or not ("true" or "false")booleantrue
allowedAddressCities--allowedAddressCities specifies an array of allowed states for the address example {"SA":{"XX1":["Riady","Afif"],"XX2":["Jeddah","Makkah"]},"US":{"US1":["San Jose","San Francisco"],"US2":["New york"]}}{ [index: string]: CitySpecs; }undefined
allowedAddressCountries--allowedAddressCountries specifies an array of allowed countries for the addressstring[]undefined
allowedAddressStates--allowedAddressStates specifies an array of allowed states for the address example {"SA":{"XX1":"State 1","XX2":"State 2"},"US":{"US1":"State 1","US2":"State 2"}}{ [index: string]: StateSpecs; }undefined
amountamountThe amount of money to charge the customernumberundefined
countryCodecountry-codeThe country code of the merchant (e.g. SA)string"SA"
darkModedark-modeDark Mode: - on: turns on dark mode - off: turns on light mode - auto: use customer preference for dark mode"auto" | "off" | "on""off"
debugdebugdebug flag for verbose printing of debug messagesbooleanfalse
disableddisableddisables the checkout buttonbooleanfalse
discountdiscountdiscount specifies any discount to be appliednumber0
discountDescriptiondiscount-descriptiondiscountDescription provides description for the discountstringundefined
feesfeesfees specifies any fees to be appliednumber0
feesDescriptionfees-descriptionfeesDescription provides description for the feesstringundefined
emailRequiredemail-requiredemailRequired specifies if email address is required or not ("true" or "false"). Can only be true if addressRequired is true.booleanfalse
enablePreCheckoutTriggerenable-pre-checkout-triggerenable triggering a pre checkout click event to do initial tasks such as adding items to cartsbooleanfalse
enablePrePayTriggerenable-pre-pay-triggerenable triggering a pre pay event to do final task such as order creationbooleanfalse
initialAddress--initialAddress specifies a default address, Country field is country code (two letter ISO country code)IAddressundefined
initialEmailinitial-emailinitialEmail specifies a default emailstringundefined
initialPhoneNumberinitial-phone-numberinitialPhone specifies a default phone numberstringundefined
initialFirstNameinitial-first-nameinitialFirstName specifies a default first namestringundefined
initial-first-nameinitial-last-nameinitialLastName specifies a default last namestringundefined
labellabelthe label of the button. Either checkout for final checkout or quicky-buy for per product buy"checkout" | "quick-buy""checkout"
localelocalethe language of the plugin. supported languages are Arabic ("ar") and English ("en")string"en"
merchantIdmerchant-idmerchantId is the key to use obtained from
refIdref-idrefId a unique identifier to be included in the payment transactionstringundefined
uniqueRefunique-refuniqueRef a boolean to enforce the uniqueness of refIdbooleanfalse
shippingMethods--shippingMethods an array of shipping methodsIShippingMethod[][]
showContinueShoppingButtonshow-continue-shopping-buttondebug flag for verbose printing of debug messagesbooleanfalse
taxestaxestaxes specifies any additional taxesnumber0
testEnvironmenttest-environmentthis is an internal testing feature. don't specifystringundefined
installmentOptionsUrlinstallment-options-urlThe installment options url is URL for the checkout page in the merchant websitestringundefined
postcodeOptionalCountriesinstallment-options-urlenable postal code required optionstring[]undefined


amwalAddressUpdateamwalAddressUpdate is a dom event fired on address selection. It waits for either amwalAddressAck or amwalAddressTriggerError events to be sent back before proceeding to address update or aborting respectively.CustomEvent<IAddress>
amwalCheckoutSuccessamwalCheckoutSuccess is a dom event fired on success of payment. the event has orderId field which can be used to lookup transaction status at<AmwalCheckoutStatus>
amwalDismissedamwalDismissed is a dom event fired when the amwal modal or popup window is dismissed, event.detail indicates if it's successfull or not (boolean)CustomEvent<any>
amwalPreCheckoutTriggeramwalPreCheckoutTrigger is a dom event fired once amwal checkout button is clicked before a transaction is created. It is enabled if enablePreCheckoutTrigger is set. It waits for either amwalPreCheckoutTriggerAck or amwalPreCheckoutTriggerError events to be sent back before proceeding with the normal checkout flow.CustomEvent<ITransactionDetails>
amwalPrePayTriggeramwalPrePayTrigger is a dom event fired once payment button is clicked before payment is processed. It is enabled if enablePrePayTrigger is set. It waits for either amwalPrePayTriggerAck or amwalPrePayTriggerError events to be sent back before proceeding to payment or aborting respectively.CustomEvent<ITransactionDetails>
updateOrderOnPaymentsuccessupdateOrderOnPaymentsuccess is a dom event fired on success of payment. the event has orderId field which can be used to lookup transaction status at<AmwalCheckoutStatus>


This project was generated with Angular CLI version 14.2.9.