About paysafecard

General information about paysafecard

Paysafecard is a prepaid card that consumers buy in shops in order to subsequently shop online. Since this is a prepaid means of payment, this system is free from chargebacks. In addition it offers merchants a payment guarantee.

Paysafecard is widespread in the gaming, gambling and adult content sectors. The previous Wallie-card has now been adopted into the paysafecard system. You can tap into additional target groups with this prepaid system:

  • customers who do not want to disclose personal data such as bank account or credit card number
  • young people who are denied access to classic payment systems such as credit cards
  • customers who do not obtain a credit card from their bank
  • as well as customers who prefer to pay with paysafecard

The prepaid system is international: the paysafecard Group operates in 27 countries in Europe as well as in North and Latin America and processes around 20 million prepaid payments annually.


Logo

Info

paysafecard is a prepaid card which is a widespread micropayment method for gaming, gambling and adult-content.

TypePayments by Prepaid


Further information can be found on the webpage of paysafecard (www.paysafecard.com).


Connections to paysafecard

You can link paysafecard payment methods either directly or via PPRO. If via PPRO, all transactions are posted as sales without further posting. However cancellation and batch processing is not possible. In this case the additional PPRO parameters are required.

With direct connection via the  the merchant can choose whether to carry out sales transactions or separately posted transactions. Please contact  for help with the necessary merchant configuration. In the variant with separate posting you can also carry out cancellations for the whole amount or for amounts not yet posted. In addition in this case batch processing is also possible for postings and cancellations.

 

Process flow chart


paysafecard process flow


 interface


Payment with paysafecard via form interface

To make a payment with paysafecard over a form, please use the following URL:

psc.aspx


Key

Format

CND

Description

Beschreibung

RefNr

ans..30

OC

Unique reference number.

In case of PPRO: Only characters a-zA-Z0-9,-_ are allowed, format ans..40.

Eindeutige Referenznummer.

Bei PPRO: Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt, Format ans..40.

Key

Format

CND

Description

Beschreibung

OrderDesc

ans..768

M

Description of delivered goods, unit prices etc.

Beschreibung der gelieferten Waren, Einzelpreise etc.

Key

Format

CND

Description

Beschreibung

Language

a2

O

Language: <de> German (default), <en> English

Sprache: <de> Deutsch (Standard), <en> Englisch

Key

Format

CND

Description

Beschreibung

CustomerID

ans..50

M

ID for uniquely identifying the customerID um den Kunden eindeutig zu identifizieren

DispositionRestrictionAge

n..3

O

Age restriction for the paysafecard user account

Altersbeschränkung für das Benutzerkonto bei paysafecard
DispositionRestrictionKYCans..20ORestriction of KYC level (Know Your Customer)Einschränkung des KYC-Levels (Know Your Customer)
DispositionRestrictionCountrya2ORestriction to a given country. Two characters country code according to ISO 3166Einschränkung auf ein bestimmtes Land. Ländercode zweistellig gemäß ISO 3166
SubIDans..8OSupport for reporting filters for paysafecard payments; must be agreed with paysafecard.Unterstützung von Berichtsfiltern für paysafecard-Zahlungen; muss mit paysafecard abgestimmt werden.

Key

Format

CND

Description

Beschreibung




Additional parameters for connection via PPROZusatzparameter bei PPRO-Anbindung

AccOwner

ans..50

M

Name of account holder

Name des Kontoinhabers

AddrCountryCodea2MTwo characters country code according to ISO 3166Ländercode zweistellig gemäß ISO 3166

Parameters for payments with paysafecard


Key

Format

CND

Description

Beschreibung

RefNr

ans..30

OC

Merchant’s unique reference number.

In case of PPRO: Only characters a-zA-Z0-9,-_ are allowed, format ans..40.

Referenznummer des Händlers.

Bei PPRO: Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt, Format ans..40.

Key

Format

CND

Description

Beschreibung




Additional parameters for connection via PPROZusatzparameter bei PPRO-Anbindung

Key

Format

CND

Description

Beschreibung

TransactionIDan..20OUnique transaction number from PPROEindeutige Transaktionsnummer bei PPRO

Return parameters for URLSuccess, URLFailure and URLNotify with paysafecard



Capture of a payment with paysafecard

Captures are possible via a Server-to-Server connection. Captures are possible only if you have a direct connection to paysafecard and if this is configured for the merchant at . To carry out a Capture for paysafecard via a Server-to-Server connection, please use the following URL:

capture.aspx


Parameters for captures of paysafecard via socket connections


Response parameters for captures of paysafecard via socket connections



Reversal

Reversals are possible via a Server-to-Server connection. Reversals are possible only if you have a direct connection to paysafecard and if this is configured for the merchant at . The  permits only reversals that reference on a capture previously made via . Depending on the previous transaction status all as-yet unposted amounts can be cancelled.

To carry out a reversal with a reference transaction, please use the following URL:

reverse.aspx


Parameters for reversal of payments with paysafecard via socket connection


Response parameters for reversals of paysafecard via socket connections



Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing of payments / reversal for paysafecard and which information can be found within the response file about the payment status. Batch processing is possible only if you have a direct connection to paysafecard and if this is configured for the merchant at .

Following table gives an overview of all batch versions that are possible for a specific action and their specialities:

Action

Version

Description

Beschreibung

Capture

1.0 / 2.0

Standard version without return of parameter Code

Standardversion ohne Rückgabe von Parameter Code


1.x / 2.x

with RefNr (valid for all versions other than 1.0)

mit RefNr (gilt für alle Versionen außer 1.0)

Reverse

1.0 / 2.0

Standard version without return of parameter Code

Standardversion ohne Rückgabe von Parameter Code

 

1.x / 2x.

with RefNr (valid for all versions other than 1.0)

mit RefNr (gilt für alle Versionen außer 1.0)


Description of the possible batch versions


The structure for a paysafecard payment within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
Paysafecard,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
Paysafecard,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

HEAD,[Master]MerchantID,Date,2.x
Type,Action,[Slave]MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount

Key

Format

CND

Description

Beschreibung

Type

a..11

M

HEAD for Header, FOOT for Footer, Paysafecard for paysafecard

HEAD für Header, FOOT für Footer, Paysafecard für Paysafecard

Action

a..20

M

The parameter Action defines the type of transaction:

Credit

Reverse (cancellation)

Der Action-Parameter definiert die Art der Transaktion:

Credit (Gutschrift)
Reverse (Storno)

Key

Format

CND

Description

Beschreibung

RefNr

ans..30

O

Unique reference number.

In case of PPRO: Only characters a-zA-Z0-9,-_ are allowed, format ans..40.

Eindeutige Referenznummer.

Bei PPRO: Nur die Zeichen a-zA-Z0-9,-_ sind erlaubt, Format ans..40.

Description of fields within the record for Batch files

 

The record area within the response file for Batch transactions looks the following way:

HEAD,<MerchantID>,<Date>,<Version>
Paysafecard,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>, <Code>
Paysafecard,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>, <Code>
FOOT,<CountRecords>,<SumAmount>

Key

Format

CND

Description

Beschreibung

Action

a..20

M

The parameter Action defines the type of transaction:

Capture
Reverse

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)
Reverse (Storno)

Description of result parameters within the record for Batch files