How to use the Pay API (EPP)

(This example is not meant to be used in production mode)

<form method="post" action="https://api.raisenow.com/epayment/api/step/pay/merchant/1234567890" >
    success_url<br/><input type="text" name="success_url" value="https://localhost/response.html"/><br/><br/>
    error_url<br/><input type="text" name="error_url" value="https://localhost/response.html"/><br/><br/>
    cancel_url<br/><input type="text" name="cancel_url" value="https://localhost/response.html"/><br/><br/>
    test_mode<br/><input type="text" name="test_mode" value="true"/><br/><br/>
    mobile_mode<br/><input type="text" name="mobile_mode"  value="false"/><br/><br/>
    amount<br/><input type="text" name="amount" value="500"/><br/><br/>
    currency<br/><input type="text" name="currency" value="chf"/><br/><br/>
    language<br/><input type="text" name="language" value="de"/><br/><br/>
    payment_method<br/><input type="text" name="payment_method" value="vis"/><br/><br/>
    <input type="submit"/>
</form>

Submitting the form will result in a redirect to a second form depending on the payment method. In the above snippet the form will be posted to the pay_api (aka API endpoint). This URL ends with your merchant config ID (aka api key). All fields in this form are mandatory and have to be sent to our service for initiating a successful transaction:

• success_url, error_url, cancel_url define the redirect after a transaction was successful, incorrect or aborted by the user.

• test_mode defines if a real payment is triggered or not

• mobile_mode defines if the mobile optimized versions of the forms are returned or not

• amount defines the amount in Rappen

• currency defines currency in ISO 4217 Currency Codes

• language defines the used language in ISO 6391 Codes

• payment_method defines the payment method, e.g. sms (SMS), vis (Visa), pfc (PostFinance Card), ezs (Payment Slip)

Further details about each parameter can be found in the section parameter.

We use basis authentification for web api e payment: your log in is the api-user and password provided by us.

To finish a payment transaction, the form has to be sent to the payment provider. After the transaction is processed, the request will be redirected either to your success, error or cancel URL. When one of these URLs is called, payment specific parameters are added as query parameter. The most important parameter is the epp_transaction_id which identifies your transaction. Processing of a transaction or requesting the status of a transaction can be done using this epp_transaction_id. Please also visit the Webservice API section for further information. Another important parameter is called epayment_status which defines the status of the transaction (e.g. success, error).