Account functions  FAQ  X-Rates  Gold&Silver News  Fees  CAP  Sitemap


e-dinar Merchant Access (for integration into shopping cart software)



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 variabledescription
recipient_accounte-dinar account number of the merchant account, i.e. your account number
amountamount of the transaction (12.90)
currencycurrency which can be one of the following:
ozg ozs usd eur aed chf jpy
metalmetal can be gold or silver
memoprefill memo field
merchant_referencereference 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 variabledescription
transaction_idtransaction reference number from the e-dinar system. This value is only passed on if the transaction was successful
recipient_accounte-dinar account number of the merchant account, i.e. your account number
sender_accounte-dinar account number of the client (the sender)
amountamount of the transaction (12.90)
currencycurrency which can be one of the following:
ozg ozs usd eur aed chf jpy
metalmetal can be gold or silver
memoprefill memo field
exchangerateexchange rate at the time of the transaction
merchant_referencereference number of the merchant system (as received in the first step)
handover_fieldsevery 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.  
 

back top of page contact sitemap