About PayU LatAm

General information about payment methods via PayU LatAm

Logo

Info

Within the extremely heterogeneous e-commerce market of Latin America success depends on offering the requested payment methods. The integration of PayU gives the merchant access to 74 payment methods from Mexico to Argentina. Besides all major online transfers as well as credit and debit cards PayU also offers payments with modern e-wallets and popular cash-in-payments.

Type

Mixed payment methods

Card Scheme
MasterCard
VISA
AMEX
Diners
Hipercard
Elo
NARANJA
SHOPPING
CABAL
ARGENCARD
CENCOSUD

Process flow charts

PayU LatAm process flow

Process flow PayU LatAm via form interface payssl.aspx

Process flow PayU LatAm via server-to-server interface direct.aspx

interface

Payment with PayU LatAm via form interface

To make a payment with PayU LatAm in Latin America, please use the following URL:

payulatam.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLP, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLP, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
Discount	n..10	O	Discount in the smallest currency unit	Nachlass in der kleinsten Währungseinheit
Language	a2	O	Language: EN – English (default) ES – Spanish PT – Portuguese	Sprache: EN – Englisch (Standard) ES – Spanisch PT – Portugiesisch
CountryCode	a2	M	Country code of that country where the transaction should be executed ‒ 2 characters according to ISO 3166: AR, BR, CO, CL, MX, PA, PE	Ländercode, in welchem Land die Zahlung ausgeführt werden soll ‒ zweistellig gemäß ISO 3166: AR, BR, CO, CL, MX, PA, PE
TaxCode	a2	O	VAT rate, e.g. 1900 for 19% Default is 0 (no VAT)	Umsatzsteuersatz z.B. 1900 für 19% Standard ist 0 (keine Umsatzsteuer)
NetAmount	n..4	OC	Total amount of the order without VAT and delivery costs in the smallest currency unit. NetAmount may only be used if also TaxCode is submitted.	Gesamtbetrag der Bestellung ohne MwSt. und Lieferkosten in der kleinsten Währungseinheit. NetAmount darf nur angegeben werden, wenn auch ein TaxCode übergeben wird.

Key	Format	CND	Description	Beschreibung
			Contact data	Kontaktdaten
Name	ans..128	O	Name of the customer	Name des Käufers
CreditCardHolder	ans..50	O	Name of the credit card holder	Name des Kreditkarteninhabers
AddrStreet	ans..255	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
AddrCity	ans..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
AddrZip	ans..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
AddrCountryCode	a2	O	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse, zweistellig gemäß ISO 3166
eMail	ans..128	M	Email address of the purchaser. Only characters a-zA-Z0-9.-_@ are allowed.	E-Mail-Adresse des Käufers. Nur die Zeichen a-zA-Z0-9.-_@ sind zulässig.
Phone	ans..40	O	Purchaser’s telephone number	Telefonnummer des Käufers
WorkPhone	ans..40	O	Phone number of the customer at working place	Telefonnummer des Käufers am Arbeitsplatz
MobileNo	ans..20	O	Mobile phone number of the customer	Mobiltelefonnummer des Käufers
TaxNumber	ans..20	O	Identification number of the customer. This value will be used in the credit card form.	Die Identifikationsnummer des Käufers. Der Wert wird im Kreditkarten-Formular verwendet.
bdeMail	ans..128	O	Email address of the purchaser	E-Mail-Adresse des Bezahlers
bdPhone	ans..40	O	Phone number of the payor	Telefonnummer des Bezahlers
bdWorkPhone	ans..40	O	Phone number of the payor at working place	Telefonnummer des Bezahlers am Arbeitsplatz
bdMobileNo	ans..20	O	Mobile phone number of the payor	Mobiltelefonnummer des Bezahlers
sdStreet	ans..255	O	Street in the delivery address	Straßenname der Lieferadresse
sdCity	ans..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
sdCountryCode	a2	O	Country code for the delivery address, 2 characters according to ISO 3166	Ländercode der Lieferadresse, zweistellig gemäß ISO 3166

Parameters for payments with PayU LatAm in Latin America

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Return parameters for URLSuccess and URLFailure with PayU LatAm in Latin America

The following table gives the results parameters which the transfers to URLNotify:

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key

Format

CND

Description

Beschreibung

AmountAuth

n..10

M

Actually authorized amount in the smallest currency unit.

For installment payments the charges are added automatically to the initial amount.

Tatsächlich autorisierter Betrag in der kleinsten Währungseinheit.

Bei Ratenzahlungen werden automatisch die Gebühren zum ursprünglichen Betrag addiert.

TransactionID

ans..25

O

RefNr from PayU system

RefNr des PayU-Systems

PayType

ans..25

O

Name of used payment method

Name der genutzten Zahlungsart

Return parameters for URLNotify with PayU LatAm in Latin America

Credit card payment with PayU LatAm via form interface

In order to execute an SSL credit card payment in Latin America with PayU LatAm via a form, please use the following URL:

payssl.aspx

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	M	Unique reference number which appears on your printed card account or in the EPA-file (Electronic Payment Advice). Format must be mutually agreed beforehand with !	Eindeutige Referenznummer, die auf Ihrer gedruckten Kartenabrechnung oder in der EPA-Datei (Electronic Payment Advice) erscheint. Das Format muss vorher mit abgestimmt werden!

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLP, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLP, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
Language	a2	O	Language: EN – English (default) ES – Spanish PT – Portuguese	Sprache: EN – Englisch (Standard) ES – Spanisch PT – Portugiesisch
CountryCode	a2	O	Country code of that country where the transaction should be executed ‒ 2 characters according to ISO 3166: AR, BR, CO, CL, MX, PA, PE	Ländercode, in welchem Land die Zahlung ausgeführt werden soll ‒ zweistellig gemäß ISO 3166: AR, BR, CO, CL, MX, PA, PE
TermsAndConditions	a..3	OC	yes or no. Terms and Conditions from PayU, which the customer has to accept. It is only mandatory if a PayU-account which is registered in Brazil is connected with a bank within another country.	yes oder no. Terms and Conditions von PayU, die der Käufer akzeptieren muss. Ist nur verpflichtend, wenn der in Brasilien registrierte PayU-Account mit einer Bank in einem anderen Land verknüpft ist.

Key	Format	CND	Description	Beschreibung
			Contact data	Kontaktdaten
Name	ans..128	OC	Name of the customer. If not specified, the CreditCardHolder must be submitted.	Name des Kunden. Wenn nicht angegeben, muss CreditCardHolder übergeben werden.
CreditCardHolder	ans..50	OC	Name of the credit card holder. If not specified, the Name must be submitted.	Name des Kreditkarteninhabers. Wenn nicht angegeben, muss Name übergeben werden.
Mail	ans..128	O	Email address of the customer	E-Mail-Adresse des Kunden
AddrStreet	ans..255	O	Customer’s street name	Straßenname des Kunden
AddrCity	ans..50	O	Town/city of the customer	Ortsname des Kunden
AddrState	ans..40	O	Federal State of the customer	Bundesland (Bundesstaat) des Kunden
AddrCountryCode	a2	O	Country code of the customer, 2 characters according to ISO 3166.	Ländercode des Kunden, zweistellig gemäß ISO 3166
eMail	ans..128	O	Email address of the purchaser	E-Mail-Adresse des Käufers
AddrZIP	ans..20	O	Postcode of the customer	Postleitzahl des Kunden
Phone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
CustomerID	ans..16	O	Customer ID or customer number	Kundennummer des Kunden
CustomerClassification	a..8	O	Customer classification (business/private) default=private	Kundenklassifizierung (business / private) Standard=private
TaxNumber	an11/an14	O	Identification number of the customer In Brazil there are two kinds of tax numbers: CPF for persons and CNPJ for companies. The discrimination is made by the parameter CustomerClassification. CPF: 11 characters without separators, e.g. 12312312312 CNPJ: 14 characters without separators, e.g. 12345678000123	Identifikationsnummer des Kunden In Brasilien gibt es zwei Arten von Steuernummern: CPF für Personen und CNPJ für Firmen. Die Unterscheidung wird durch den Parameter CustomerClassification getroffen. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312 CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123
bdeMail	ans..128	O	Email address in the billing address	E-Mail-Adresse der Rechnungsadresse
bdCustomerID	ans..16	O	Customer number in the billing address	Kundennummer der Rechnungsadresse
bdDateOfBirth	ans10	O	Date of birth in the format YYYY-MM-DD	Geburtsdatum im Format YYYY-MM-DD
bdPhone	ans..40	O	Phone number in the billing address	Telefonnummer der Rechnungsadresse
bdTaxNumber	n11	O	Identification number of the payor. This value is used in the credit card form. CPF: 11 characters without separators, e.g. 12312312312	Identifikationsnummer des Bezahlers. Dieser Wert wird im Kreditkartenformular verwendet. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312
bdStreet	ans..255	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddrAddition	ans..50	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..40	O	Federal State in the billing address	Bundesland (Bundesstaat) der Rechnungsadresse
bdCountryCode	a2	O	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse, zweistellig gemäß ISO 3166
sdStreet	ans..255	O	Street in the delivery address	Straßenname der Lieferadresse
sdAddrAddition	ans..50	O	Address addition in the delivery address	Adresszusatz der Lieferadresse
sdCity	ans..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
sdState	ans..40	O	Federal State in the delivery address	Bundesland (Bundesstaat) der Lieferadresse
sdCountryCode	a2	O	Country code for the delivery address, 2 characters according to ISO 3166	Ländercode der Lieferadresse, zweistellig gemäß ISO 3166
sdZip	ans..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer der Lieferadresse

Parameters for credit card payments with PayU LatAm in Latin America

Key

Format

CND

Description

Beschreibung

Language

a2

(enum)

M

Language code: <de> German, <al> Albanian, <at> Austrian, <cz/cs> Czech, <dk> Danish, <en> English, <fi> Finish, <fr> French, <gr> Greek, <hu> Hungarian, <it> Italian, <jp> Japanese, <nl> Dutch, <no> Norwegian, <pl> Polish, <pt> Portuguese, <ro> Romanian, <ru> Russian, <sp> Spanish, <se> Swedish, <sk> Slovakian, <sl> Slovenian, <tr> Turkey, <zh> Simplified Chinese.

No details means the language is German.

Sprachcode: <de> deutsch, <al> albanisch, <at> österreichisch, <cz/cs> tschechisch, <dk> dänisch, <en> englisch, <fi> finnisch, <fr> französisch, <gr> griechisch, <hu> ungarisch, <it> italienisch, <jp> japanisch, <nl> holländisch, <no> norwegisch, <pl> polnisch, <pt> portugiesisch, <ro> rumänisch, <ru> russisch, <tr> türkisch, <sp> spanisch, <se> schwedisch, <sk> slowakisch, <sl> slowenisch, <tr> türkisch, <zh> Simplified Chinese.

Ohne Angabe ist die Sprache Deutsch.

CCSelect

a..10

M

Determines preselected card type in the form: VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD

Bestimmt die vorausgewählte Kartenmarke im Formular: VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD

Layout parameters for forms for credit card payments with PayU LatAm

Key

Format

CND

Description

Beschreibung

Status

a..50

M

OK or FAILED

Additionally only for URLNotify: AUTHORIZE_REQUEST

OK oder FAILED

Nur bei URLNotify zusätzlich: AUTHORIZE_REQUEST

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Description of the credit card brand like VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD
CCExpiry	n6	O	In combination with PCNr: Expiry date of the credit card in the format YYYYMM	In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

Return parameters for URLSuccess, URLFailure and URLNotify with PayU LatAm

Credit card payment via Server-to-Server connection

In order to execute an SSL credit card payment with PayU LatAm in Latin America via a server-to-server connection, please use the following URL:

direct.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLP, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLP, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key

Format

CND

Description

Beschreibung

Capture

an..6

OC

Determines the type and time of capture.

Capture Mode	Description
MANUAL	Capturing made by the merchant. Capture is normally initiated at time of delivery.
AUTO	Capturing immediately after authorisation (default value).
<Number>	Delay in hours until the capture (whole number; 1 to 696).

Only in Brazil but not with brand Hipercard.

Bestimmt Art und Zeitpunkt der Buchung (engl. Capture).

Buchungsart	Beschreibung
AUTO	Buchung sofort nach Autorisierung (Standardwert).
MANUAL	Buchung erfolgt durch den Händler - in der Regel die Buchung zum Zeitpunkt der Warenauslieferung bzw. Leistungserbringung.
<Zahl>	Verzögerung in Stunden bis zur Buchung (ganze Zahl; 1 bis 696).

Nur in Brasilien, aber nicht bei der Marke Hipercard.

Key	Format	CND	Description	Beschreibung
CCCVC	n..4	O	Card verification number: The last 3 digits on the signature strip of the credit card. 4 characters in the case of AMEX.	Kartenprüfnummer: Die letzten 3 Ziffern auf dem Unterschriftsfeld der Kreditkarte. Bei AMEX 4 Ziffern.
CCExpiry	n6	M	Credit card expiry date (YYYYMM), e.g. 202607	Ablaufdatum der Kreditkarte (JJJJMM), z.B. 202607
CCBrand	a..22	M	Card type: VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD Please note the spelling!	Kartenmarke: VISA, MasterCard, AMEX, DINERS, Elo, Hipercard, NARANJA, SHOPPING, CABAL, ARGENCARD, CENCOSUD Bitte beachten Sie die Schreibweise!
CreditCardHolder	ans..60	O	Name of the card holder	Name des Karteninhabers
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise usw.
InstallmentNumber	n..2	O	Number of months of the payment by instalments (1-12), default=1	Anzahl Monate der Ratenzahlung (1-12), Standard=1
Language	a2	O	Language: EN – English (default) ES – Spanish PT – Portuguese	Sprache: EN – Englisch (Standard) ES – Spanisch PT – Portugiesisch
CountryCode	a2	M	Country code of that country where the transaction should be executed ‒ 2 characters according to ISO 3166: AR, BR, CO, CL, MX, PA, PE	Ländercode, in welchem Land die Zahlung ausgeführt werden soll ‒ zweistellig gemäß ISO 3166: AR, BR, CO, CL, MX, PA, PE
TermsAndConditions	a..3	OC	yes or no. Terms and Conditions from PayU, which the customer has to accept. It is only mandatory if a PayU-account which is registered in Brazil is connected with a bank within another country.	yes oder no. Terms and Conditions von PayU, die der Käufer akzeptieren muss. Ist nur verpflichtend, wenn der in Brasilien registrierte PayU-Account mit einer Bank in einem anderen Land verknüpft ist.

Key	Format	CND	Description	Beschreibung
			Contact data	Kontaktdaten
Name	ans..128	OC	Name of the customer. If not specified, the CreditCardHolder must be submitted.	Name des Kunden. Wenn nicht angegeben, muss CreditCardHolder übergeben werden.
CreditCardHolder	ans..128	OC	Name of the credit card holder. If not specified, the Name must be submitted.	Name des Kreditkarteninhabers. Wenn nicht angegeben, muss Name übergeben werden.
Mail	ans..128	O	Email address of the customer	E-Mail-Adresse des Kunden
AddrStreet	ans..255	O	Customer’s street name	Straßenname des Kunden
AddrCity	ans..50	O	Town/city of the customer	Ortsname des Kunden
AddrState	ans..40	O	Federal State of the customer	Bundesland (Bundesstaat) des Kunden
AddrCountryCode	a2	O	Country code of the customer, 2 characters according to ISO 3166.	Ländercode des Kunden, zweistellig gemäß ISO 3166
eMail	ans..128	O	Email address of the purchaser	E-Mail-Adresse des Käufers
AddrZIP	ans..20	O	Postcode of the customer	Postleitzahl des Kunden
Phone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
CustomerID	ans..16	O	Customer ID or customer number	Kundennummer des Kunden
CustomerClassification	a..8	O	Customer classification (business/private) default=private	Kundenklassifizierung (business / private) Standard=private
TaxNumber	an11/an14	O	Identification number of the customer In Brazil there are two kinds of tax numbers: CPF for persons and CNPJ for companies. The discrimination is made by the parameter CustomerClassification. CPF: 11 characters without separators, e.g. 12312312312 CNPJ: 14 characters without separators, e.g. 12345678000123	Identifikationsnummer des Kunden In Brasilien gibt es zwei Arten von Steuernummern: CPF für Personen und CNPJ für Firmen. Die Unterscheidung wird durch den Parameter CustomerClassification getroffen. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312 CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123
bdeMail	ans..128	O	Email address in the billing address	E-Mail-Adresse der Rechnungsadresse
bdCustomerID	ans..16	O	Customer number in the billing address	Kundennummer der Rechnungsadresse
bdDateOfBirth	ans10	O	Date of birth in the format YYYY-MM-DD	Geburtsdatum im Format JJJJ-MM-TT
bdPhone	ans..40	O	Phone number in the billing address	Telefonnummer der Rechnungsadresse
bdTaxNumber	n11	O	Identification number of the payor. This value is used in the credit card form. CPF: 11 characters without separators, e.g. 12312312312	Identifikationsnummer des Bezahlers. Dieser Wert wird im Kreditkartenformular verwendet. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312
bdStreet	ans..255	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddrAddition	ans..50	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..40	O	Federal State in the billing address	Bundesland (Bundesstaat) der Rechnungsadresse
bdCountryCode	a2	O	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse, zweistellig gemäß ISO 3166
sdStreet	ans..255	O	Street in the delivery address	Straßenname der Lieferadresse
sdAddrAddition	ans..50	O	Address addition in the delivery address	Adresszusatz der Lieferadresse
sdCity	ans..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
sdState	ans..40	O	Federal State in the delivery address	Bundesland (Bundesstaat) der Lieferadresse
sdCountryCode	a2	O	Country code for the delivery address, 2 characters according to ISO 3166	Ländercode der Lieferadresse, zweistellig gemäß ISO 3166
sdZip	ans..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer der Lieferadresse

Parameters for credit card payments with PayU LatAm via socket connection

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
CCBrand	a..22	O	In combination with PCNr: Name of credit card brand, e.g. Visa, MasterCard, Amex, DINERS etc.	In Verbindung mit PCNr: Bezeichnung der Kreditkartenmarke wie VISA, MasterCard, AMEX, DINERS etc.
CCExpiry	n6	O	In combination with PCNr: Expiry date of the credit card in the format YYYYMM	In Verbindung mit PCNr: Ablaufdatum der Kreditkarte im Format JJJJMM

Results parameters for socket connection with PayU LatAm

Cash payment with PayU in Latin America

In order to execute a CashPayment payment with PayU LatAm in Latin America via a server-to-server connection, please use the following URL:

cashpayment.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLP, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLP, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	M	Description of purchased goods, unit prices etc.	Beschreibung der gekauften Waren, Einzelpreise etc.

Key	Format	CND	Description	Beschreibung
IPAddr	ans..15	O	IP address. If you transfer the IP address, can determine in which country and in which town your customer has connected with the Internet (see also IPZone). Format: 123.456.789.012	IP-Adresse. Damit kann das ermitteln, in welchem Land und welcher Stadt Ihr Kunde mit dem Internet verbunden ist (vgl. IPZone). Format 123.456.789.012
Language	a2	O	Language: EN – English (default) ES – Spanish PT – Portuguese	Sprache: EN – Englisch (Standard) ES – Spanisch PT – Portugiesisch
CountryCode	a2	M	Country code of that country where the transaction should be executed ‒ 2 characters according to ISO 3166: AR, BR, CO, CL, MX, PA, PE	Ländercode, in welchem Land die Zahlung ausgeführt werden soll ‒ zweistellig gemäß ISO 3166: AR, BR, CO, CL, MX, PA, PE
TermsAndConditions	a..3	OC	yes or no. Terms and Conditions from PayU, which the customer has to accept. It is only mandatory if a PayU-account which is registered in Brazil is connected with a bank within another country.	yes oder no. Terms and Conditions von PayU, die der Käufer akzeptieren muss. Ist nur verpflichtend, wenn der in Brasilien registrierte PayU-Account mit einer Bank in einem anderen Land verknüpft ist.
PayType	a..25	O	Name of used payment method Argentina: PAGOFACIL, RAPIPAGO, COBRO_EXPRESS, BAPRO, RIPSA Brazil: BOLETO_BANCARIO Colombia: EFECTY, PSE Mexico: OXXO, BANCOMER, IXE, SCOTIABANK, SANTANDER, SEVEN_ELEVEN Peru: BCP	Name der verwendeten Zahlungsart Argentinien: PAGOFACIL, RAPIPAGO, COBRO_EXPRESS, BAPRO, RIPSA Brasilien: BOLETO_BANCARIO Kolumbien: EFECTY, PSE Mexiko: OXXO, BANCOMER, IXE, SCOTIABANK, SANTANDER, SEVEN_ELEVEN Peru: BCP

Key	Format	CND	Description	Beschreibung
			Contact data	Kontaktdaten
Name	ans..128	OC	Mandatory In Brazil: Name of the customer	In Brasilien Pflicht: Name des Kunden
Mail	ans..128	OC	Mandatory In Brazil: Email address of the customer	In Brasilien Pflicht: E-Mail-Adresse des Kunden
AddrStreet	ans..255	OC	Mandatory In Brazil: Customer’s street name	In Brasilien Pflicht: Straßenname des Kunden
AddrCity	ans..50	OC	Mandatory In Brazil: Town/city of the customer	In Brasilien Pflicht: Ortsname des Kunden
AddrState	ans..40	OC	Mandatory In Brazil: Federal State of the customer	In Brasilien Pflicht: Bundesland (Bundesstaat) des Kunden
AddrZIP	ans..20	OC	Mandatory In Brazil: Postcode of the customer	In Brasilien Pflicht: Postleitzahl des Kunden
AddrCountryCode	a2	O	Country code of the customer, 2 characters according to ISO 3166.	Ländercode des Kunden, zweistellig gemäß ISO 3166
eMail	ans..128	O	Email address of the purchaser	E-Mail-Adresse des Käufers
AddrZIP	ans..20	O	Postcode of the customer	Postleitzahl des Kunden
Phone	ans..40	O	Customer’s phone number	Telefonnummer des Kunden
CustomerID	ans..16	O	Customer ID or customer number	Kundennummer des Kunden
CustomerClassification	a..8	O	Customer classification (business/private) default=private	Kundenklassifizierung (business / private) Standard=private
TaxNumber	ans..20	OC	Mandatory In Brazil: Identification number of the customer In Brazil there are two kinds of tax numbers: CPF for persons and CNPJ for companies. The discrimination is made by the parameter CustomerClassification. CPF: 11 characters without separators, e.g. 12312312312 CNPJ: 14 characters without separators, e.g. 12345678000123	In Brasilien Pflicht: Identifikationsnummer des Kunden In Brasilien gibt es zwei Arten von Steuernummern: CPF für Personen und CNPJ für Firmen. Die Unterscheidung wird durch den Parameter CustomerClassification getroffen. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312 CNPJ: 14 Zeichen, ohne Trennzeichen, z.B. 12345678000123
bdeMail	ans..128	O	Email address in the billing address	E-Mail-Adresse der Rechnungsadresse
bdCustomerID	ans..16	O	Customer number in the billing address	Kundennummer der Rechnungsadresse
bdDateOfBirth	ans10	O	Date of birth in the format YYYY-MM-DD	Geburtsdatum im Format JJJJ-MM-TT
bdPhone	ans..40	O	Phone number in the billing address	Telefonnummer der Rechnungsadresse
bdTaxNumber	n11	O	Identification number of the payor. This value is used in the credit card form. CPF: 11 characters without separators, e.g. 12312312312	Identifikationsnummer des Bezahlers. Dieser Wert wird im Kreditkartenformular verwendet. CPF: 11 Zeichen ohne Trennzeichen, z.B. 12312312312
bdStreet	ans..255	O	Street name in the invoicing address	Straßenname der Rechnungsadresse
bdAddrAddition	ans..50	O	Address addition in the billing address	Adresszusatz der Rechnungsadresse
bdCity	ans..50	O	Name of town/city in the billing address	Ortsname der Rechnungsadresse
bdZip	ans..20	O	Postcode in the invoicing address	Postleitzahl der Rechnungsadresse
bdState	ans..40	O	Federal State in the billing address	Bundesland (Bundesstaat) der Rechnungsadresse
bdCountryCode	a2	O	Country code for the invoicing address, 2 characters according to ISO 3166	Ländercode der Rechnungsadresse, zweistellig gemäß ISO 3166
sdStreet	ans..255	O	Street in the delivery address	Straßenname der Lieferadresse
sdAddrAddition	ans..50	O	Address addition in the delivery address	Adresszusatz der Lieferadresse
sdCity	ans..50	O	Town/city in the delivery address	Ortsname der Lieferadresse
sdState	ans..40	O	Federal State in the delivery address	Bundesland (Bundesstaat) der Lieferadresse
sdCountryCode	a2	O	Country code for the delivery address, 2 characters according to ISO 3166	Ländercode der Lieferadresse, zweistellig gemäß ISO 3166
sdZip	ans..20	O	Postcode in the delivery address	Postleitzahl der Lieferadresse
sdPhone	ans..40	O	Phone number in the delivery address	Telefonnummer der Lieferadresse

Parameters for payments with PayU CashPayment via socket connection

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	M	Reference number is returned, if it was previously submitted	Wenn zuvor übergeben, wird die Referenznummer zurückgegeben

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
PaymentSlipLink	ans..256	M	Complete URL (URL-encoded) for the page which presents the payment form	Vollständige URL (URL-encoded) für die Seite, die den Zahlschein darstellt

Results parameters for socket connection with PayU CashPayment

The following table describes the parameters which the returns to URLNotify:

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	M	Reference number is returned, if it was previously submitted	Wenn zuvor übergeben, wird die Referenznummer zurückgegeben

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLP, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLP, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Response parameters to URLNotify for payments with PayU CashPayment

Capture of a credit card payment with PayU LatAm

Captures are possible via a Server-to-Server connection. To carry out a Capture for a credit card payment with PayU LatAm via a Server-to-Server connection, please use the following URL:

capture.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLO, COP, MXN, PEN and USD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLO, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
RefNr	ans..30	O	Unique reference number which appears on your printed card account or in the EPA-file (Electronic Payment Advice). Format must be mutually agreed beforehand with !	Eindeutige Referenznummer, die auf Ihrer gedruckten Kartenabrechnung oder in der EPA-Datei (Electronic Payment Advice) erscheint. Das Format muss zuvor mit abgestimmt werden!

Parameters for captures of PayU LatAm via socket connections

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Response parameters for captures of PayU LatAm via socket connections

Credit with reference

credit.aspx

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLO, COP, MXN, PEN and USD permitted. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLO, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

Key	Format	CND	Description	Beschreibung
OrderDesc	ans..768	O	Description of refunded goods, unit prices, merchant’s comment etc.	Beschreibung der gutgeschriebenen Artikel, Einzelpreise, Händlerkommentar etc.

Parameters for credit payments with PayU LatAm via socket connection

Key	Format	CND	Description	Beschreibung
CodeExt	n..10	O	Error code from PayU, if agreed with	Fehlercode von PayU, wenn mit abgesprochen
ErrorText	ans..256	O	Error text from PayU, if agreed with	Fehlertext von PayU, wenn mit abgesprochen

Response parameters for credit payments with PayU LatAm via socket connection

Batch processing via the interface

This section describes the parameters which must be transferred within the data set (Record) for executing of payments / credits for PayU LatAm in Latin America 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:

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)
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 PayU LatAm payment within a Batch file to be submitted is the following:

HEAD,<MerchantID>,<Date>,<Version>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>
CC,Credit,<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, CC for Credit card payment with PayU

HEAD für Header, FOOT für Footer, CC für Kreditkartenzahlung mit PayU

Action

a..20

M

The parameter Action defines the type of transaction:

Capture

Credit

Der Action-Parameter definiert die Art der Transaktion:

Capture (Buchung)

Credit (Gutschrift)

Key	Format	CND	Description	Beschreibung
Currency	a3	M	Currency, three digits DIN / ISO 4217, e.g. EUR. Presently only ARS, BRL, CLO, COP, MXN, PEN and USD allowed. Please find an overview here: A1 Currency table	Währung, drei Zeichen DIN / ISO 4217, z.B. EUR. Derzeit nur ARS, BRL, CLO, COP, MXN, PEN und USD zulässig. Hier eine Übersicht: A1 Währungstabelle

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>
CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code>
CC,Credit,<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 Credit	Der Action-Parameter definiert die Art der Transaktion: Capture (Buchung) Credit (Gutschrift)

Description of result parameters within the record for Batch files