Presentation of methods
The JavaScript client supports events during integration: Initialize payment form.
Method | Description | SmartForm case |
---|---|---|
KR.openPaymentMethod() | Called to offer a payment method directly when opening a pop-in (or pop-up) without giving a choice to the buyer. | YES |
KR.getPaymentMethods() | Called for listing the available payment methods. | YES |
KR.userPaymentMethodsOrder() | Called for managing the display order of the payment methods. | YES |
KR.field.focus() | Called to give focus to a form field. |
KR.setFormConfig() | allows to overloadinitialization parametersfromformToken . |
KR.setBrand() | Called to force the detection of the payment method. |
KR.onFormCreated() | The payment form is ready but the content of iframes has not loaded yet. |
KR.onFormReady() | The form is ready to be used. |
KR.submit() | Submits the form(). Equivalent to the user clicking the form button. |
KR.validate() | Obsolete, to useKR.validateForm() |
KR.validateForm() | Called to trigger the local validation of the form. |
The following methods are obsolete and are no longer supported. They should not be used :.
- KR.validate(): use KR.validateForm()
- KR.registerPlugin()
Display management in on-board mode.
Method | Description |
---|---|
KR.fields.pan.help.button.hide() | Hides the PAN help icon |
KR.fields.pan.help.button.show() | Shows the PAN help icon |
KR.fields.cvv.hide() | Hide the CVV |
KR.fields.cvv.show() | Displays the CVV |
Pop-in display management.
Method | Description |
---|---|
KR.closePopin() | Closes the pop-in (if open). |
KR.openPopin() | Opens the Pop-in (if closed) |
KR.setShopName() | Change the name of the shop defined in the header of the Pop-in. |
Dynamic form management (add, remove DOM):
Method | Description |
---|---|
KR.addForm(CSS class or id) | Adds a form to a DOM element. Returns a formId. |
KR.attachForm(CSS class or id) | Obsolete, to useKR.renderElements() |
KR.renderElements(CSS class or id) | Enable the form on an existing DOM. Returns a formId. |
KR.hideForm(formId) | Hide the form |
KR.removeEventCallbacks() | Deletes all previously attached callbacks using KR.on[*] functions. |
KR.removeForms() | Removes all forms from the DOM (automatically calls KR.removeEventCallbacks() ) |
KR.showForm(formId) | Displaying a form |
See: embedded-form-glue.
Managing the payment form submission button:
PARAMETER | Description |
---|---|
KR.button.setLabel('MON LABEL %amount-and-currency% ') | Defines a label where %amount-and-currency% will be replaced by the amount and currency |
KR.button.showSpinner() | Displays the waiting animation |
KR.button.hideSpinner() | Hides the waiting animation |
KR.button.disable() | Disables the button (not clickable) |
KR.button.enable() | Activate the button |