Table of Contents

About SafetyPay

General information about SafetyPay

SafetyPay, whose head office is in Florida, offers an international system for online bank transfers, with which the customers pay for international purchases in their own currency using their familiar online banking system. Merchants reach out to about 250 million potential bank customers, especially in Brazil, Costa Rica, Mexico, Austria, Peru, Spain and the USA.

Page properties

Logo

Info

Excerpt
SafetyPay is the world’s leading real-time online bank transfer with access to over 250 million banking customers in Europe, the USA, Canada and Latin America, with immediate payment guarantee, fast disbursement and simple refunding. That means no chargebacks, no risk of fraud, no payment default. It supports mobile, telephone/mail order, E-Invoices and offers sales promotions.

Type

Payments by Online Bank Transfer

Further information you will find also on the webpage of SafetyPay (www.safetypay.de).

Process flow chart

Multiexcerpt

MultiExcerptName	ProcessFlow

draw.io Diagram

border	true
diagramName	ProcessFlow_Safetypay_CT
simpleViewer	false
links	auto
tbstyle	top
lbox	true
diagramWidth	1109

SafetyPay process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Definition
PageWithExcerpt	Definition EN

Payment with SafetyPay via form interface

In order to process an international online transfer with SafetyPay via a

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Platform-Kurz
PageWithExcerpt	Wording

form, please use the following URL:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

safetypay.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657623244756_-1549363128
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	safetypay_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657623244758_1152679754
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR, USD, GBP. Only EUR and USD permissible. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR, USD, GBP. Nur EUR und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of goods and prices etc. Intended purpose on the statement of account.	Beschreibung der Waren, Einzelpreise usw., Verwendungszweck auf dem Kontoauszug.

Table Excerpt Include

static	true
name	URLSuccess
page	URLSuccess
type	page

Table Excerpt Include

static	true
name	URLFailure
page	URLFailure
type	page

Table Excerpt Include

static	true
name	Response
page	Response
type	page

Table Excerpt Include

static	true
name	URLNotify
page	URLNotify
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Table Excerpt Include

static	true
name	SellingPoint
page	SellingPoint
type	page

Table Excerpt Include

static	true
name	Service
page	Service
type	page

Table Excerpt Include

static	true
name	Channel
page	Channel
type	page

Key	Format	CND	Description	Beschreibung
Language	a2	O	2-letter language code (e.g. de) that should be preferred when presenting payment pages to the consumer	2-stelliger Sprachcode (z. B. de), der bei der Darstellung von Zahlungsseiten für den Kunden bevorzugt werden sollte
AccOwner	ans..50	M	Name of account holder	Name des Kontoinhabers
AddrCountryCode	a2	M	Country code for the account holder’s invoicing address, 2 characters according to ISO 3166. Only AT, BE, BR, CL, CR, DE, EC, ES, MX, NL, PE permissible.	Ländercode der Rechnungsadresse des Kontoinhabers zweistellig gemäß ISO 3166. Nur AT, BE, BR, CL, CR, DE, EC, ES, MX, NL, PE zulässig.

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Parameters for payments with SafetyPay

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_IntroURL
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657623512833_-1852242087
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	safetypay_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657623512835_1738895832
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	Status_OK_AUTHORIZE_REQUEST
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	UserData
page	UserData
type	page

Table Excerpt Include

static	true
name	PaymentPurpose
page	PaymentPurpose
type	page

Table Excerpt Include

static	true
name	PaymentGuarantee
page	PaymentGuarantee
type	page

Table Excerpt Include

static	true
name	ErrorText_PPRO
page	ErrorText
type	page

Table Excerpt Include

static	true
name	TransactionID_PPRO
page	TransactionId
type	page

Table Excerpt Include

static	true
name	Plain
page	Plain
type	page

Table Excerpt Include

static	true
name	Custom
page	Custom
type	page

Return parameters for URLSuccess, URLFailure and URLNotify with SafetyPay

Credit with reference

Credits (refunds) are possible via a Server-to-Server connection. For a Credit with reference to a capture the amount of the Credit is limited to the amount of the previous capture.

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

Multiexcerpt include

MultiExcerptName
SpaceWithExcerpt	EN

BaseURL

Credit_Intro
PageWithExcerpt	Reuse API

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	BaseURL
PageWithExcerpt	Wording

credit.aspx

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657621753479_25282120
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657621753481_781247315
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MerchantID
page	MerchantID
type	page

Table Excerpt Include

static	true
name	PayID_Credit
page	PayID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	MAC
page	MAC
type	page

Table Excerpt Include

static	true
name	ReqId-ans..32
page	ReqId
type	page

Parameters for credit payments with SafetyPay via socket connection

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Response_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657621839412_-1189968811
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	credit_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657621839414_1726594996
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Table Excerpt Include

static	true
name	MID
page	mid
type	page

Table Excerpt Include

static	true
name	PayID
page	PayID
type	page

Table Excerpt Include

static	true
name	XID
page	XID
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Description
page	Description
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	ErrorText_PPRO
page	ErrorText
type	page

Response parameters for credit payments with SafetyPay via socket connection

Batch processing via the interface

Basic information about using Batch files and about their structure can be found in the Batch Manager manual. Within batch processing not alle functions are available which are usually available for the online interface.

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Intro
PageWithExcerpt	Reuse API

This section describes the parameters which must be transferred within the data set (This section describes the parameters which must be transferred within the data set (Record) for executing a SafetyPay credit and which information can be found within the response file about the payment status.

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

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657624689968_-1317809648
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_versions

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657624689970_-636665826
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Action	Version	Description	Beschreibung
Credit	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)

Description of the possible batch versions

The structure for a SafetyPay credit within a Batch file to be submitted is the following:

Multiexcerpt

MultiExcerptName	batch_structure
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
SafetyPay,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
FOOT,<CountRecords>,<SumAmount>

Example for Master MID function:

Multiexcerpt

MultiExcerptName	batch_MasterMid
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

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

The following table describes the individual fields and values used within the data set (record) within the batch file:

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Request_Intro
PageWithExcerpt	Reuse API

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657625086962_-278330112
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_request

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657625086964_1826221017
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key	Format	CND	Description	Beschreibung
Type	a..11	M	HEAD for Header, FOOT for Footer, SafetyPay for SafetyPay	HEAD für Header, FOOT für Footer, SafetyPay für SafetyPay
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Table Excerpt Include

name	Amount
page	Amount
type	page

Table Excerpt Include

static	true
name	Currency
page	Currency
type	page

Table Excerpt Include

static	true
name	TransID
page	TransID
type	page

Table Excerpt Include

static	true
name	RefNr_PPRO
page	refnr
type	page

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Description of fields within the record for Batch files

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

Multiexcerpt

MultiExcerptName	batch_structure_response
shouldDisplayInlineCommentsInIncludes	false

Code Block

language	xml

HEAD,<MerchantID>,<Date>,<Version>
SafetyPay,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
FOOT,<CountRecords>,<SumAmount>

Multiexcerpt include

SpaceWithExcerpt	EN
MultiExcerptName	Batch_Response_Intro
PageWithExcerpt	Reuse API

The following table describes the response parameters which the Batch Manager saves in the Record area for each transaction (standard parameters not explained here, such as <TransID> or <RefNR> and request parameters are returned unchanged and correspond to the call as specified before):

Table Filter

default	Beschreibung
isFirstTimeEnter	false
hideColumns	true
sparkName	Sparkline
hidePane	true
datepattern	dd M yy
id	1657625321136_278648373
worklog	365\|5\|8\|y w d h m\|y w d h m
isOR	AND
separator	Point (.)
order	0

Multiexcerpt

MultiExcerptName	batch_response

Table Transformer

dateFormat	dd M yy
export-word	false
show-source	false
export-csv	false
id	1657625321138_-464008783
transpose	false
worklog	365\|5\|8\|y w d h m\|y w d h m
separator	.
export-pdf	false
sql	SELECT * FROM T*

Key	Format	CND	Description	Beschreibung
Action	a..20	M	The parameter Action defines the type of transaction: Credit	Der Action-Parameter definiert die Art der Transaktion: Credit (Gutschrift)

Table Excerpt Include

static	true
name	PayID_Batch
page	PayID
type	page

Table Excerpt Include

static	true
name	Status_OK_FAILED
page	Status
type	page

Table Excerpt Include

static	true
name	Code
page	Code
type	page

Description of result parameters within the record for Batch files

Space shortcuts

Page tree

Versions Compared

Old Version 4

New Version 5

Key

About SafetyPay

General information about SafetyPay

Process flow chart

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface

Payment with SafetyPay via form interface

Credit with reference

Batch processing via the interface

Paygate

Computop

Help

Intranet Tools

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 4

New Version 5

Key

About SafetyPay

General information about SafetyPay

Process flow chart

Multiexcerpt includeSpaceWithExcerptENMultiExcerptNamePlatform-KurzPageWithExcerptWording interface

Payment with SafetyPay via form interface

Credit with reference

Batch processing via the interface

Multiexcerpt include
SpaceWithExcerpt EN
MultiExcerptName Platform-Kurz
PageWithExcerpt Wording
interface