Paysafecard
Accept Paysafecard payments in your online store.
Paysafecard is a prepaid payment method that allows your users to make online transactions securely and anonymously using a unique PIN code. Use the emerchantpay Paysafecard API to accept Paysafecard as a payment method across the supported emerchantpay payment integrations.
| Payment method | Countries/regions |
|---|---|
| Pre-paid vouchers and cash payments | Worldwide |
Prerequisites
1. Create a Paysafecard payment request
To submit a payment using Paysafecard, create a payment request to the emerchantpay payment gateway. Specify paysafecard as the transaction_type.
<payment_transaction>
<transaction_type>paysafecard</transaction_type>
<transaction_id>119643250547501c79d8295</transaction_id>
<usage>40208 concert tickets</usage>
<remote_ip>245.253.2.12</remote_ip>
<return_success_url>http://www.example.com/success</return_success_url>
<return_failure_url>http://www.example.com/failure</return_failure_url>
<amount>100</amount>
<currency>USD</currency>
<customer_email>jsmith@example.com</customer_email>
<customer_phone>+1987987987987</customer_phone>
<billing_address>
<first_name>John</first_name>
<last_name>Smith</last_name>
<address1>45 North Str</address1>
<zip_code>W1T 2QS</zip_code>
<city>London</city>
<country>UK</country>
</billing_address>
</payment_transaction>
2. Receive a response
You will receive a Success or Error response to your payment request.
Example of a Success response:
<payment_response>
<transaction_type>paysafecard</transaction_type>
<status>pending_async</status>
<mode>live</mode>
<transaction_id>119643250547501c79d8295</transaction_id>
<unique_id>44177a21403427eb96664a6d7e5d5d48</unique_id>
<technical_message>Transaction successful!</technical_message>
<message>Transaction successful!</message>
<redirect_url>https://staging.gate.emerchantpay.net/redirect/to_acquirer/649e1ff35c61</redirect_url>
<timestamp>2023-05-01T07:12:53Z</timestamp>
<descriptor>Acme Co.</descriptor>
<amount>100</amount>
<currency>USD</currency>
<sent_to_acquirer>true</sent_to_acquirer>
</payment_response>redirect_url to redirect your customer to authorise the payment with Paysafecard. See the emerchantpay Paysafecard API documentation for the complete list of Paysafecard response parameters and code samples.
Asynchronous notification
Because the Paysafecard payment transaction is asynchronous, the result of your customer’s payment is sent as a separate HTTP POST notification from the gateway to the notification_url that you supplied with the transaction request.
Example of a notification for a Paysafecard transaction:
“transaction”: “2120648291”
“terminal_token”: “e834daebe636a8452925d566c821a9594be8e990”
“unique”: “3181e1bc71653991edf187bdd10a8cbc”
“transaction_type”: “paysafecard”
“status”: “declined”
“signature”: “a830b5099e5669e13d9116c220b0b2a0f366bcb4”
“amount”: “1000”
status field provides you with information on the outcome of the transaction. See Transaction States for more information about transaction statuses.
Use the signature field to verify that the notification has been sent by the emerchantpay payment gateway. Each session signature is generated by combining the unique_id of the transaction and your API password, and generating a SHA-1 hash function of the combined string.
signature = SHA-1 hash value of <unique_id><API password>
| unique_id | API password | signature |
|---|---|---|
| 26aa150ee68b1b2d6758a0e6c44fce4c | 50fd87e65eb415f42fb5af4c9cf497662e00b785 | c5219b3d385e74496b2b48a549 |
| 3f760162ef57a829011e5e2379b3fa17 | 50fd87e65eb415f42fb5af4c9cf497662e00b785 | 14519d0db2f7f8f407efccc9b099 |
After you have verified the notification state and validity, render an XML page containing the transaction’s unique id to acknowledge that you have received the notification.
Example of a notification reply you use to confirm a notification:<?xml version=”1.0″ encoding=”UTF-8″?>
<notification_echo>
<unique_id>3f760162ef57a829011e5e2379b3fa17</unique_id>
</notification_echo>
3. Test your integration
Before you can accept live payments, you must test your integration in the staging environment.
- Add an item to your cart in your online store.
- Proceed to the checkout page and check out using Paysafecard.
- Follow the redirect link in the response.
- In the payment simulator, follow the instructions to simulate a transaction.
- Complete the order and verify that you are redirected to the order confirmation page.
- Log in to the Gateway Console.
- In the navigation menu, go to Payment transactions.
- Verify that the transaction appears at the top of the list and is successful.
4. Accept live payments
After you have successfully tested your Paysafecard integration, you are ready to move to the production environment and accept live payments. Contact your emerchantpay Account Manager to get your login credentials for the production environment.
