Skip to main content

iWallet

Craftgate is integrated with iWallet which is one of the alternative payment methods. With the API and the Common Payment Page, you can easily receive payments from iWallet users.

Things to do first​

In order to use the iWallet integration, you must have completed the following steps.

  1. Alternative Payment Methods must be On on Merchant Panel > Administration > Merchant Settings > Craftgate Features list.

    Alternative Payment Methods in Craftgate Features

  2. Enter the information sent to you by iWallet on Merchant Panel > Administration > APM Management > iWallet after Enable iWallet Integration status.

    iWallet integration settings

Payment via iWallet​

You can receive payments from iWallet users via Craftgate API and Common Payment Page. See: Payment with Payment Form

Payment via iWallet From API​

You can integrate with alternative payment methods service via Craftgate API to receive iWallet payments. Payment via iWallet from API has 2 steps.

1. APM Payment Init: You should send additional parameters like below for init iWallet Payment.

additionalParams
map

iWallet card number should be placed in this parameter like this["cardNumber" : "1234567812345678"].

If APM Payment Init Response additionalAction field has value OTP_REQUIRED, APM Payment Complete request is needed for completion. If additionalAction has value NONE, payment is completed no additional step needed.

For more information, see Pay With Alternative Payment Methods

2. APM Payment Complete: You should complete iWallet APM payment after init completed. You should send additional parameters like below for complete.

paymentId
number
required

Payment id.

additionalParams
map
required

iWallet verification code or card pass should be placed in this parameter like this["passCode" : "1234"].

For more information, see Complete Alternative Payment Methods

Payment via iWallet From Common Payment Page​

The payment experience and flow can be summarized as follows.

  1. The following notification message will be displayed when the iWallet tab is selected.

    iWallet Common Payment Page Tab

  2. Verification code input will be displayed when Pay button is clicked.

    iWallet Common Payment Page Tab

  3. When the user write own iWallet card number and verificaiton code which by sent iWallet and the Pay button is clicked, payment will be completed and the user is directed to the callbackUrl address which is sent while payment form init request. See: Payment with Payment Form

Receive Payment Only via iWallet​

If you send ["IWALLET"] with the enabledPaymentMethods parameter in the payment form initiation request, the card payment tab will not be displayed to the user. Only the iWallet tab will be accessible.

Only iWallet Tab

Sample Codes for Init iWallet APM​

Java.NETPHPNode.jsGo

Sample Codes for Complete iWallet APM​

Java.NETPHPNode.jsGo