Payment Process

1. The customer selects the payment method PaysafeCard.

2. Initiate Payment: Send POST request createDisposition.

   • 2.1. If the response gives back http20x, redirect the customer to the payment panel.

   • 2.2. If the response gives back http40x or http50x, show an error message to the customer.

     Initiate Payment error message:

     Transaction could not be initiated due to connection problems. If the problem persists, please contact our business partner support.

3. Redirection to the payment panel getCustomerPanel: The customer reaches the payment panel.

4. PIN entry by customer: The customer enters a valid PIN and clicks pay.

   • 4.1. Verification is performed on PaysafeCard's side to confirm whether the entered PINs are valid. If the customer cancels the transaction on the payment panel, show the following error message:

     Transaction aborted by user

5. Payment notification delivery: Since the card is assigned to the transaction, transaction status S, PaysafeCard sends a notification to your pnUrl.

6. pnUrl handling: Right after payment notification delivery, perform the GET request getSerialNumbers to check the state of the transaction.

   • 6.1. If the GET request getSerialNumbers returns the corresponding status S, immediately perform the POST request executeDebit.

   • 6.2. If the response of executeDebit is http20X, the resultCode is 0, and the errorCode is 0, make a user account top up.

7. Redirection to the okUrl: Redirect the customer to your okUrl.

8. okUrl handling: Query the state of the transaction with the GET request getSerialNumbers once the customer lands on the okUrl.

   • 8.1. If the GET request getSerialNumbers returns the status O, show a success message to the customer.

   • 8.2. If the status is S, perform the POST request executeDebit.

     • 8.2.1. If the response gives back http20X, the resultCode is 0, and the errorCode is 0, make a user account top up and show a success message to the customer.

     • 8.2.2. If the response gives back http40X or http50X, and/or result/errorCode != 0, show an error message to the customer.

   • 8.3. If the response from getSerialNumbers gives back http40X or http50X, show an error message to the customer.

     Retrieve Payment Details error message:

     The transaction could not be completed. This may have happened due to a temporary connection problem. Please press the reload button in your browser to retry completing your transaction. If the problem persists, please contact our business partner support.