 |
e-dinar provides a secure merchant interface. The merchant interface has the address:
https://www.e-dinar.com/cgi/pay.cgi
The interface accepts the following POST variables:
| POST variable | description |
| recipient_account | e-dinar account number of the merchant account, i.e. your account number |
| amount | amount of the transaction (12.90) |
| currency | currency which can be one of the following: ozg ozs usd eur aed chf jpy |
| metal | metal can be gold or silver |
| memo | prefill memo field |
| merchant_reference | reference number of the merchant system |
| handover_fields
| comma-separated list of fieldnames - fields to be handed over to the merchant system after the transaction has been completed |
After a successful / unsuccessful transaction, the client will be redirected to either the Success URL or the Failure URL. The following variables will be POSTed to that URL:
| POST variable | description |
| transaction_id | transaction reference number from the e-dinar system. This value is only passed on if the transaction was successful |
| recipient_account | e-dinar account number of the merchant account, i.e. your account number |
| sender_account | e-dinar account number of the client (the sender) |
| amount | amount of the transaction (12.90) |
| currency | currency which can be one of the following: ozg ozs usd eur aed chf jpy |
| metal | metal can be gold or silver |
| memo | prefill memo field |
| exchangerate | exchange rate at the time of the transaction |
| merchant_reference | reference number of the merchant system (as received in the first step) |
| handover_fields | every field from the list of handover_fields will be passed back to the merchant system |
After a successfull transaction, all relevant data can be POSTed from the e-dinar system to a Callback URL which the merchant can specify in the account configuration. All variables which are sent to the Success URL are also sent to the Callback URL. In addition, a Callback Password (fieldname: callback_password) will be sent. This Callback Password can be used to verify the authenticity of the received message.
We suggest that you only use secure connections (https://) for the callback function.
Following is a description of all configuration fields which are relevant for the shopping cart interface. In order to setup this function please login to your account and go to "Configure Account".
|
|
Allow Merchant Access
|
Check this box, if you want to allow Merchant Access to your account. With Merchant Access, you can integrate e-dinar
into your shopping software and allow automated payments with e-dinar.
|
|
Merchant Name
|
This name will be displayed to the buyer on the payment page.
|
|
Merchant Description
|
This description will be displayed to the buyer on the payment page.
|
|
Success URL
|
Once the buyer has successfully made the payment, he/she is redirected to the Success URL.
All relevant data will be sent to this URL with the POST method.
This URL is usually located at the shopping system of the merchant. The URL must start with either http:// or https://
|
|
Failure URL
|
If the payment was not successful, the buyer is redirected back to the merchant system via the Failure URL.
All relevant data will be sent to this URL with the POST method.
This URL is usually located at the shopping system of the merchant. The URL must start with either http:// or https://
|
|
Callback Enabled
|
enable or disable Callback function
|
|
Callback URL
|
If the payment was successful, all relevant data will be posted to this URL which can then be used by the merchant system to
process the payment. The POST data will include a password (which you can set further down on this page) to verify the data received.
This URL is usually located at the shopping system of the merchant. The URL must start with either http:// or https://
|
|
Callback Password
|
The merchant can use the Callback Password together with the Callback URL to verify the authenticity of the data
sent to the Callback URL by use of this password.
|
| |
 |
|
|