Difference between revisions of "Ideal technical details"
From Kolmisoft Wiki
Jump to navigationJump to search
m (→What is Ideal?) |
|||
| Line 24: | Line 24: | ||
This is IDEAL setup page in MOR: | This is IDEAL setup page in MOR: | ||
[[File:Payment_gateways_ideal_basic.png]] | |||
*Enabled | * '''Enabled''' - Check this box to make iDEAL available for your clients. | ||
Check this box to make iDEAL available for your clients. | |||
* Acquirer bank | * '''Acquirer bank''' - Select bank that issued your iDEAL account. | ||
Select bank that issued your iDEAL account. | |||
* Merchant ID | * '''Merchant ID''' - Your merchant ID from iDEAL. You can find it in iDEAL control panel. | ||
Your merchant ID from iDEAL. You can find it in iDEAL control panel. | |||
* Passphrase | * '''Passphrase''' - Enter passphrase that you used when you generated you certificates. To get more information about generating certificates refer to [[Link title]] | ||
Enter passphrase that you used when you generated you certificates. | |||
* Payment description | * '''Payment description''' - Custom textual description that describes what your customer is paying for. | ||
Custom textual description that describes what your customer is paying for. | |||
* Private key (*.pem) | *''' Private key (*.pem)''' - Upload private key that you have generated. More information in "Generate certificates" | ||
Upload private key that you have generated. More information in "Generate certificates" | |||
* Private certificate (*.cer) | * '''Private certificate (*.cer)''' - Upload a certificate that you have generated. More information can be found in "Generate certificates" | ||
Upload certificate that you have generated. More information in "Generate certificates" | |||
* Ideal certificate (*.cer) | * '''Ideal certificate (*.cer)''' - Select certificate file that can download from your iDEAL provider. | ||
Select certificate file that can download from your iDEAL provider. | |||
* Tax in amount | * '''Tax in amount''' - "Include" tax into amount that user has to pay or "Exclude" if you want to exclude the tax from the amount that is added to user's balance | ||
"Include" tax into amount that user has to pay or "Exclude" if you want to exclude the tax from the amount that is added to user's balance | |||
* Minimum amount | * '''Minimum amount''' - Minimum payment amount | ||
Minimum payment amount | |||
* Maximum amount | * '''Maximum amount''' - Maximum payment amount. | ||
Maximum payment amount. | |||
* Client pays transaction fee | * '''Client pays transaction fee''' - Check to additionally charge the client for the transaction fee. | ||
* Transaction fee amount | * '''Transaction fee amount''' - Enter transaction fee amount if you have enabled "Client pays transaction fee" | ||
Enter transaction fee amount if you have enabled "Client pays transaction fee" | |||
* Payment confirmation by you | * '''Payment confirmation by you''' | ||
** '''Not required''' - No confirmation is required. Every payment is added to clients balance immediately. | |||
** '''Required for suspicious payments''' - currently iDEAL doesn't provide enough info to calculate suspiciousness. | |||
** '''Required for all payments''' - When payments are completed they must be confirmed manually. | |||
* Notify by email | * '''Notify by email''' - Check to receive notifications by email. | ||
* Test mode | * '''Test mode''' - Turns on the test mode. Use this option only if you know what you are doing. In test mode MOR will send payment requests to bank's test environment, so the payments will not transfer actual money. On the other hand MOR still counts these payments as real and updates user's balance. | ||
Turns on test mode. Use | |||
* Logo | * '''Logo''' - You can select and upload a custom logo picture. MOR accepts images that are *.jpg, *.png or *.gif and less that 100Kb in size. | ||
You can select and upload custom logo picture. MOR accepts images that are *.jpg, *.png or *.gif and less that 100Kb in size. | |||
=Generate certificates= | =Generate certificates= | ||
Revision as of 12:55, 24 September 2010
What is iDeal?
iDEAL is an Internet payment method in The Netherlands, based on online banking. Introduced in 2005, this payment method allows customers to buy securely on the Internet using direct online transfers from their bank account. iDEAL processed 4,5 million transfers in 2006, 15 million transfers in 2007, 28 million transfers in 2008 and 45.4 million in 2009[1]. iDEAL is owned by the Dutch organization Currence, which also owns PIN and Chipknip.
Where to find iDeal settings?
1. Navigate to ADDONS - Payment gateways
2. Select the marked iDeal logo:
How can I setup Ideal?
This example is made using ING bank as an example. Control panels of other banks may differ but the process should be similar.
This is IDEAL setup page in MOR:
- Enabled - Check this box to make iDEAL available for your clients.
- Acquirer bank - Select bank that issued your iDEAL account.
- Merchant ID - Your merchant ID from iDEAL. You can find it in iDEAL control panel.
- Passphrase - Enter passphrase that you used when you generated you certificates. To get more information about generating certificates refer to Link title
- Payment description - Custom textual description that describes what your customer is paying for.
- Private key (*.pem) - Upload private key that you have generated. More information in "Generate certificates"
- Private certificate (*.cer) - Upload a certificate that you have generated. More information can be found in "Generate certificates"
- Ideal certificate (*.cer) - Select certificate file that can download from your iDEAL provider.
- Tax in amount - "Include" tax into amount that user has to pay or "Exclude" if you want to exclude the tax from the amount that is added to user's balance
- Minimum amount - Minimum payment amount
- Maximum amount - Maximum payment amount.
- Client pays transaction fee - Check to additionally charge the client for the transaction fee.
- Transaction fee amount - Enter transaction fee amount if you have enabled "Client pays transaction fee"
- Payment confirmation by you
- Not required - No confirmation is required. Every payment is added to clients balance immediately.
- Required for suspicious payments - currently iDEAL doesn't provide enough info to calculate suspiciousness.
- Required for all payments - When payments are completed they must be confirmed manually.
- Notify by email - Check to receive notifications by email.
- Test mode - Turns on the test mode. Use this option only if you know what you are doing. In test mode MOR will send payment requests to bank's test environment, so the payments will not transfer actual money. On the other hand MOR still counts these payments as real and updates user's balance.
- Logo - You can select and upload a custom logo picture. MOR accepts images that are *.jpg, *.png or *.gif and less that 100Kb in size.
Generate certificates
In LINUX console type commands, but replace the_passphrase with your desired passphrase. Do not forget your passphrase because you should enter it in iDEAL configuration window.
/usr/bin/openssl genrsa -des3 -out private_key.pem -passout pass:the_passphrase 1024 /usr/bin/openssl req -x509 -new -key private_key.pem -passin pass:the_passphrase -days 3650 -out private_certificate.cer
From: [1]
Payment statuses
Successful:
- Completed - Payment is made and completed user's balance was increased.
- Waiting for confirmation - Payment was completed by iDEAL and is currently waiting for your confirmation. Money will be added to user's balance after
Unsuccessful:
- Canceled - Payment was canceled.
- Expired - Payment expired. Usually because your customers haven't completed the payment in 60 minutes.
- Failure - There was an error in iDEAL when dealing with transaction.
Troubleshooting
"Select bank" is empty.
Check if you have entered all the configuration correctly. Check certificates.
"Select bank" shows only "Issuer Simulator" as an available bank.
"Test mode" should be turned off.
Payments "Confirmed" column displays "No (waiting_response)" and payment is not being completed.
If iDEAL fails to deliver money instantly (lag between issuer and acquirer banks) then MOR marks this payment "waiting_response" and then waits another hour and checks iDEAL again. So be patient. If waiting_response stays like that for several hours then contact our Support.
