About SimplePay

General information about SimplePay

Logo

Info

SimplePay is a secure and fast payment solution for merchants and customers. The SimplePay service is available in thousands of online stores, making financial transactions possible for customers with a Simple account (who can also use their saved card) and for other online customers.

TypePayments by eWallet

Further information can be found on the webpage of SimplePay (https://simplepay.hu/).

Important information

Please note that, unlike our currency table, the currency HUF (Hungarian ‒ Forints) must be given without decimal places.

Example: To transfer 100.00 HUF one enters the amount=100.

This exception applies only for the SimplePay payment method.

On this page


Process flow chart


SimplePay process flow


interface


Payment with SimplePay over form interface

To make a payment with SimplePay, please use the following URL:

simplepay.aspx

 

Key

Format

CND

Description

RefNr

ans..40

O

Merchant’s unique reference number

Key

Format

CND

Description

OrderDesc

ans..128

M

Description of purchased goods, unit prices etc.
Permitted characters a-z, A-Z, the digits 0-9 and the special characters :;.,?!()”.

Key

Format

CND

Description

Email

ans..32

C

Email address of the customer

Phone

n..16

O

Customer phone number

expirationTime

ans..19

O

Timestamp for the end time of the transaction processing, specified in UTC

Language

a2

O

Language of the payment page

InvoiceFlag

boolean

C

If the billing information of the buyer is not known in the merchant system, this will allow the customer to provide this information on the payment page.

ArticleList

array

O


keytype
CND
refstringArticlelist1.ArticleCodeC
titlestringArticlelist1.ArticleNameC
descstringArticlelist1.DescriptionC
amountstringArticlelist1.QuantityC
pricestringArticlelist1.UnitPriceC
taxstringArticlelist1.VAT-rateC

Articlelist1=ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Description

Articlelist2=ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Description

...

ArticlelistN=ArticleName,ArticleCode,UnitPrice,Quantity,VAT-rate,Description

ChargeAmount

n..10

O

The amount of the shipping cost specified in the currency setup in the account, which will be added to the amount payable

Discount

n..10

O

The amount of the discount specified in the currency setup in the account, which will be deducted from the amount payable

FirstName

ans..32

O

First name of the customer, if different from the value “invoice”/“name”

LastName

ans..32

O

Last name of the customer, if different from the value “invoice”/“name”

CountryCode

a2

O

Country code

Parameters for SimplePay


Invoice array

Parameter

CND

bdFirstName

bdLastName

C
bdCompanyOrPersonO
bdCountryCodeC
bdStateC
bdCityC
bdZIPC

bdStreet

bdStreetNr

C


Delivery array

If different from invoice data

Parameter

CND

sdFirstName

sdLastName

C

sdCompany

O
sdCountryCodeC
sdStateC
sdCityC
sdZipC

sdStreet

sdStreetNr

C

sdStreet2

O

sdPhone

O


Key

Format

CND

Description

RefNr

ans..40

O

Merchant’s unique reference number

Key

Format

CND

Description

TransactionID

an..20

O

Unique transaction number with SimplePay (orderRef)

Result parameters for URLNotify, URLSuccess and URLFailure in case of SimplePay

 

Example request

Plain data:

MerchantID=npesic_test&TransID=52269355424149223537&Amount=3000&Currency=HUF&RefNR=15005776&URLBack=https://computop.com/paygate-test&URLSuccess=https://computop.com/developer/blowfish-test/success.php&URLFailure=https://computop.com/developer/blowfish-test/failure.php&URLNotify=https://computop.com/developer/blowfish-test/notify.php&email=nebojsa.pesic@computop.com&Orderdesc=test



Capture

If your MID isn't configured for Sale operation, every initial SimplePay payment (call to simplepay.aspx) should be confirmed using capture.aspx endpoint or canceled via reverse.aspx.

Captures (or confirmations in terms of SimplePay) are possible via a Server-to-Server connection. To carry out a capture via a Server-to-Server connection, please use the following URL:

capture.aspx

 

Key

Format

CND

Description

CompleteType

ans..3

O

Specifies whether only a partial amount is being confirmed and authorization should be kept open. If <YES> is transferred, the possible open order is closed on capture.

Parameters for captures of SimplePay


Result parameters for captures of SimplePay


Reversal

Reversals are possible via a Server-to-Server connection. In order to cancel a payment via a server-to-server communication, please use the following URL:

reverse.aspx

 

Notice: Reverse.aspx does not only reverse authorisations, but any LAST TRANSACTION STAGE! If the last transaction was a capture, Reverse.aspx initiates the reverse, e.g. a credit. Therefore, the utmost caution is urged. Use is at your own risk. We recommend checking the transaction status with Inquire.aspx before using Reverse.aspx.

Parameters for reversals of SimplePay


Result parameters for reversals of SimplePay


Credit with reference

credit.aspx


Parameters for credit payments with SimplePay


Response parameters for credit payments with SimplePay