Help

  • The most frequent error codes are:

     

    2001 | Transaction already exists

    Make sure that the correlationId is a unique value per transaction.


    3014 | Reporting criteria unavailable

    Make sure that you are using a subId previously agreed with paysafecard.


    3034 | Reporting criteria is inactive

    Make sure that you are using a subId previously agreed with paysafecard.


    3001 | MID is inactive

    If the onboarding process is not finished yet, this is completely normal as your account remains inactive until the last integration tests are successful. If your account is live contact our technical support.


    2029 | Amount must be greater than 0

    Make sure that the transaction amount is greater than 0.


    4003 | The amount exceeds the maximum permitted amount

    Make sure that the amount of the transaction is not exceeding the maximum permitted (EUR 1,000 or equivalent in other currency).


    3002 , 10014 | Currency invalid

    The currency you are using is not activated for your account. Please contact your account manager.


    2017 | Transaction in a wrong status for this action

    Check the status of the transaction with retrieve Payment details and perform an action according to its result (please see the payment workflow).


    3007 | Debit attempt after expiry of time window

    The transaction was not closed within the disposition time window (between 1 and 10 minutes, defined by our Terms & Conditions) so it expired. The amount is returned to the customer’s paysafecard voucher or account.


    2002 | Transaction doesn't exist

    Make sure that the paymentId is a correct one.


    10008 | Authentication failed

    Make sure that you are using the correct API Key and endpoint. You can generate new API Keys in the MSC.


    10007 | General technical error

    Contact paysafecard immediately via integration@paysafecard.com if the account is not live. For live accounts, techsupport@paysafecard.com should be contacted.


    3162 | my paysafecard account not found by provided credentials

    Make sure the e-mail address entered in the payout request corresponds to the e-mail address registered in the my paysafecard account.


    3195 | Customer account details do not match

    Make sure that the name, family name and date of birth entered in the payout request match with the ones in the my paysafecard account.

  • Yes, if this is related to a certificate issued by a recognized certification authority, such as Thawte or Verisign.

  • For security reasons, our production system permits access to whitelisted IP addresses only. For this reason, we request that you provide all IP addresses which you wish to use to access our production system during the step “IP Whitelisting”.

  • In order to be able to access our system, you require access details. These are known as the API key. You can find your API Key in the MSC.

    These access details serve a verification purpose on our REST API and must be entered in your system as a required step in the technical implementation of paysafecard.

    Please note that you are obliged to keep this key confidential and to protect it from third parties. paysafecard assumes no liability for damages arising from the misuse of these access details.

  • Once the REST-API has been integrated in your test system, you will be requested to test its implementation. The MSC will supply you with a series of test cases which serve to ensure that the full range of functions of the paysafecard payments application is working.

    These detailed test cases are to be completed in real time in the order specified by the MSC. The test results are then verified by the paysafecard test system. Directly afterwards you will receive a test report summarizing all the details of the test case and providing you with information on any adjustments which may need to be made.

  • The acceptance test is done to ensure that payments with paysafecard are working as expected. This test is performed manually by our staff. Apart from checking that payments with paysafecard follow the payment workflow (https://www.paysafecard.com/fileadmin/api/de.html#/reference/zahlungsvorgang) we also check that success/error messages are shown properly to the customer and verify the use of paysafecard logos.

  • The feature test is only carried out if you implemented Payout or Refund. Its purpose is to check that these services have been implemented correctly.

    After completing the automated integration tests in the MSC you can request the feature test. This test is performed manually by our staff, to perform the test we will need access to your test environment.

  • In order to switch to the production environment, you will have to enter the production API key and change the endpoints to production. In the MSC you can find and create new API keys and will also find the endpoints.

    Please notice that before you can see this production data you will have to complete the automated integration tests in the MSC (except if you are using a verified plugin or payment gateway), also the contract must be signed and some internal business steps must be completed in our side.

  • Sample codes for the paysafecard REST API are available from the download area on our website.

  • The MSC is a tool that guides you step by step during the integration of paysafecard into your online shop. Once you are live you can check the status of your transactions there.

    Upon submitting the online form you will be logged in to the Service Center.

    During the onboarding of paysafecard you can use the MSC to:

    • Select how you wish to integrate paysafecard
    • Upload the required documents
    • Sign the partner contract
    • Complete the technical integration of paysafecard
    • Contact our support

    Once integration is completed, the MSC will remain available for you to:

    • Manage IP addresses
    • Download reports
    • Check the status of your transactions
    • Contact our support/contact information in case of emergencies

    If you are a Payment Gateway, you will only be able to use the Service Center for the technical integration of paysafecard.

  • You can integrate paysafecard directly or indirectly using a plugin, a payment gateway or a collecting/full service PSP.

    direct technical integration

    • You enter into a contract directly with paysafecard
    • Integration tests via the MSC
    • Sample code available online from the download area
    • Direct support from paysafecard
    • Notifications directly from paysafecard

     

    indirect technical integration

    • PSP –Payment Gateway
      • You enter into a contract directly with paysafecard
      • Technical integration completed by a paysafecard verified Payment Gateway
      • No technical work needs to be carried out by you.
      • Simplified integration tests - Direct support from paysafecard
      • Notifications directly from paysafecard
      • You can find a list of the Payment Gateways here
    • PSP – Collecting/Full-Service PSP
      • Contract not with paysafecard but with the collecting/Full-service PSP
      • Transactions and billing also completed by the collecting/Full-service PSP
      • No technical work needs to be carried out by you
      • You can find a list of the Collecting/Full-Service PSP here
    • Shop systems - verified paysafecard plugins
      • You enter into a contract directly with paysafecard
      • Less technical work needs to be carried out by you (only to set the shop system)
      • Simplified integration tests
      • Support from the shop system operator and paysafecard together
      • Notifications directly from paysafecard
  • It is the time you have to call “Capture Payment” after the customer authorizes the transaction.

    The "Disposition Time Window" is a contract-defined period of time. The standard length is 10 minutes. Once a customer PIN or my paysafecard has been allocated, a transaction must be completed with an "Capture Payment" call within this period of time or the reserved amount on the customer PIN or my paysafecard will be released and returned to the customer.

  • Only if "Capture Payment" is successful the amount of the transaction is debited from the customer.

    If “Capture Payment” is not called or not successful the amount of the transaction will be returned to the customer’s paysafecard voucher or account after the disposition time window.

  • The first “Capture Payment” will be successful, the following ones will fail with error code 2017.

    Once the “Capture Payment” request is completed, the transaction status updates to “SUCCESS”, meaning that it has been successfully completed. If another “Capture Payment” request is made for the same transaction, the response [http400 and Error Code = 2017] is returned. In order to avoid this the status of the transaction must always be checked with “Retrieve Payment Details” and only call “Capture Payment” if the status is “AUTHORIZED”.

  • The customer has 30 minutes to authorize the payment.

    Once a payment transaction has been created (Initiate Payment), the customer has 30 minutes to enter a PIN in the payment panel or to log in to his or her my paysafecard. Once 30 minutes have passed without a PIN or my paysafecard log-in details having been successfully entered, the transaction status will update from “REDIRECTED” to “EXPIRED”. Transactions with the status “EXPIRED” are unsuccessful and the customer must create a new payment transaction.

  • This refers to the paysafecard payment panel. After starting a transaction, you must redirect the customer to the payment panel so that she/he can enter a paysafecard PIN or her/his my paysafecard user information to authorize the transaction.

  • paysafecard transactions may have 7 different statuses

    • INITIATED:
      The initial status of a transaction once it has been created.
    • REDIRECTED:
      The customer has been successfully forwarded to the paysafecard payment panel to authorize the payment.
    • AUTHORIZED:
      The customer successfully entered a PIN at the payment panel and clicked on pay.
    • SUCCESS:
      The transaction has been successfully completed.
    • CANCELLED_MERCHANT:
      You, as the contract partner, have cancelled the payment.
    • CANCELLED_CUSTOMER:
      The customer has actively cancelled the payment in the payment panel.
    • EXPIRED:
      The customer did not authorize the transaction within the necessary time period or you, as the contract partner, did not complete the payment with within the necessary time period.
  • The paysafecard payment application is based on a REST API. REST, Representational State Transfer, is an architectural style of the World Wide Web. REST uses the standard HTTP methods (GET, POST, PUT, DELETE, etc.).

  • During the technical integration of paysafecard as a payment method you are guided by our MSC through the following steps:

    • Choose your integration type
      Choose if you are going to integrate paysafecard directly or indirectly through a plugin or a payment gateway.
    • API key/MRT access details for the test system
      paysafecard provides you with the REST API keys for testing our REST API and Merchant Reporting Tool (MRT, only available for test system to check the status of your transactions). If you are integrating with a plugin or with a Payment Gateway this step will be skipped.
    • Integration test
      A series of test cases are supplied in our MSC. These must be completed in the specified order in real time and checked against our system. If you are integrating with a plugin or with a Payment Gateway this step will be skipped. If you also implement one of our services, "Payout" or "Refund", once the integration test has been successfully completed, this feature is tested by our staff.
    • IP whitelisting for the production system
      After successfully completing the integration test, we request your IP addresses for the production system, which must be authorized in our internal system.
    • API key for the production system
      Once IP whitelisting has been completed, paysafecard will provide you with access details for the paysafecard production system. We then ask you to integrate paysafecard into your production system by entering the REST access details in your system.
    • Acceptance test
      Once this step is completed by you, our staff will carry out a final test transaction and check that the paysafecard logos and copy text are up to date and meet our quality requirements.
    • Go Live
      Once the acceptance test has been successfully completed by our staff, paysafecard will be authorized for use as a payment method for your online shop and you can start processing payments with paysafecard.
  • A transaction cannot be successfully completed without calling "Capture Payment". The transaction amount reserved on the customer PIN or my paysafecard will be released. In such a case after the disposition time window is completed, the transaction fails.