Skip to content

Paga Wallet

Paga Wallet component

Example

html
<div id="checkoutPagaWalletField"></div>
javascript
import { PagaWallet } from '@paykka/card-checkout-ui'

const checkoutPagaWallet = paykkaCheckout.create(PagaWallet, {
  onSubmit: formValidateError => {
    console.log('Paga Wallet payment submitted:', formValidateError)
  },
  onSuccess: data => {
    console.log('Paga Wallet payment successful:', data)
  },
  onError: error => {
    console.log('Paga Wallet payment failed:', error)
  }
})

checkoutPagaWallet.mount('#checkoutPagaWalletField')

Attributes

PagaWalletProps

Passed when calling the create method to create Paga Wallet.

Name Description TypeDefault
showEmailWhether to display email.
  • If set to true and email is already passed when creating the checkout, it will be displayed as disabled.
  • If set to false and email is not passed when creating the checkout, it will be displayed normally.
booleanfalse
showAddressWhether to display address.
  • If set to true and address is already passed when creating the checkout, it will be displayed normally.
  • If set to false and address is not passed when creating the checkout, it will be displayed normally.
booleanfalse
hidePaymentButtonWhether to hide the payment button. After hiding it, you can trigger payment manually through the component ref's payment() method.booleanfalse
onSubmitPayment submission callback, triggered after clicking the payment button.
  • formValidateError is the error information when form validation fails.
  • Return false to stop the payment submission.
(formValidateError?: Record<string, FormValidateError[]>) => void | boolean | Promise<void | boolean>undefined
onSuccessCallback after successful payment.
  • PaymentSuccessData contains the information returned after successful payment, please refer to.
  • This callback is also triggered when risk control is pending.
(data: PaymentSuccessData) => voidundefined
onErrorCallback after payment failure, can resubmit for payment.
  • error is a PayKKaError instance, typically containing the following properties:
    • type: Error type.
    • message: Error message.
    • code: Error code, when an API error occurs, it will return a specific error code.
(error: PayKKaError) => voidundefined
onTimeoutCallback when payment times out, can resubmit for payment.() => voidundefined
onExpiredCallback when the checkout counter has expired during payment, cannot pay again.() => voidundefined

PagaWalletRef

Methods and properties exposed by Paga Wallet, can be called by the Paga Wallet instance created via the create method, e.g.: checkoutPagaWallet.ref.payment().

Name DescriptionType
paymentMake a payment, enabled when the payment button is not visible.() => void

Below is an explanation of some data types:

PaymentSuccessData

Payment success information.

interface PaymentSuccessData {
  /** URL that can be redirected to after successful payment */
  returnUrl?: string
}