Global Payment Platform

1. The customer confirms their purchase decision by choosing Payzoff as the payment method on a site.

2. Once Shopper confirms purchase using Payzoff, Merchants must obtain a Payzoff Security code and URL to redirect a shopper to the Payzoff site to complete the payment.

Once the customer has confirmed their purchase, the merchant site will use an obtained code and URL to redirect the customer to the Payzoff site to complete payment. Merchants obtain this code and URL using standard HTTP POST commands. The URL for the POST information for all requests is: https://www.payzoff.com/api/v1.5

Request Data

Variable	Desription	Example/Value	Default	Required
api_key	Payzoff API key, obtained in the member's profile	D78CD7DAF172B2F1B55E19D9DDCE6514		Yes
action	Transaction action	payment		Yes
amount	Transaction amount	3.64		Yes
currency	Transaction currency in ISO 4217 (see http://en.wikipedia.org/wiki/ISO_4217)	USD		Yes
seller_transaction_id	Seller's unique transaction_id	123433434		Yes
signature	md5 hash: api_key + amount + seller_transaction_id + signature_key			Yes
description	Transaction description	BMW M6 Gran Coupe
return_url	URL where shopper will be redirected from Payzoff if payment was successful1 .	http://shopper-domain.com/transaction/ok		Yes
result_url	URL where shopper will get response from the Payzoff1 .	http://shopper-domain.com/transaction/result		Yes
fail_url	URL where shopper will be redirected from Payzoff if payment was unsuccessful1 .	http://shopper-domain.com/transaction/fail		Yes
name	Payer First and Last name	John Doe		Yes
method	Will use this method. Values are available here and enabled methods you may found in member area -> API configuration -> Payment Methods tab	23		No
country	Payer's country. Two lowercase letters. Required if field "method" is not empty	uk		No
bday	Payer birthday day	24		Yes
bmon	Payer birthday month	10		Yes
byear	Payer birthday year	1990		Yes
transaction_mode	0 - live mode. 1 - testing mode.You will be redirected to dummy method	1	0	No

You are required to pass this url unless you set it in your profile

Additional required fields for method SEPA Payouts (ID: 1580)

Parameter	Description	Example
iban	Payer's International Bank Account Number	DE89 3704 0044 0532 0130 00

Additional required fields for method P24 Payout (ID: 1581)

Parameter	Description	Example
iban	Payer's International Bank Account Number	DE89 3704 0044 0532 0130 00

Additional required fields for method Direct Pay

Parameter	Description	Example
iban	Payer's International Bank Account Number	987654321
bic	Payer's Bank Identifier Code	DABAIE2D

Additional required fields for method Giropay (ID: 1085)

Parameter	Description	Example
iban	Payer's International Bank Account Number	987654321
iban	Payer's Bank Identifier Code	DABAIE2D

Additional required fields for method SEPA (ID: 1068)

Parameter	Description	Example
email	Payer's email	john@example.com
iban	Payer's International Bank Account Number	987654321
iban	Payer's Bank Identifier Code	DABAIE2D

Additional required fields for method Astropaycard (ID: 6)

Parameter	Description	Example
consumerref	Payer's reference	active subscriber

Additional required fields for method Boleto Bancario (ID: 1115)

Parameter	Description	Example
nationalid	Payer's national ID	passport:AK548762
email	Payer's email	john@example.com
address	Payer's street name	West 42nd Str.
city	Payer's city	New York City
state	Payer's state	NY

Payzoff Response

You will get response in JSON format, ex:

{
  "status": "ok",
  "status_code": 0,
  "result": {
    "secret_code": "cdxbdjnGRv33LkLbtc0pN0qqVAM7xmtzzlNXGAwf",
    "transaction_id": "8439901933860",
    "redirect_url": "http:\/\/zirtz\/payment\/confirm\/8439901933860"
  }
}

Variable	Desription	Example/Value
status	Indicates if request fail or ok.	ok
status_code	Please check all status code's description here	0
result
secret_code	Unique transaction code known only to you and Payzoff. Save this value. It will be sent to result_url to verify it is a request from Payzoff.	nfiTGXzzgPKv1jy2Aeoq9PYugZBWaLiIO2vZKJCl
transaction_id	Payzoff transaction ID	4655302853830
redirect_url	Redirect customer to this URL to continue payment process on Payzoff	https://payzoff.com/payment/confirm/4655302853830

3. After the customer is redirected to the Payzoff site, they then select their payment method and confirm their payment.

4. Once the payment has been confirmed, the merchant will receive a notification at their result_url. For more information, see here).

The merchant's URL page may be coded in any language, but must accept parameters using HTTP POST standards and respond using standard format. Register the URL under Profile->Notifications in your Payzoff account or pass it along with a transaction request.
Payzoff will POST the following information to the result_url:

Variable	Desription	Example/Value
transaction_id	Payzoff transaction ID	6164701949740
amount	Amount to pay	1.56
paid_amount	Amount actually paid	1.56
create_date	Transaction create date in UNIX stamp format	1404387194
transaction_status	Transaction status	Complete
secret_code	Unique secret transaction code which is only known to you and Payzoff. You must compare it with your records to make sure that the transaction came from Payzoff	nfiTGXzzgPKv1jy2Aeoq9PYugZBWaLiIO2vZKJCl
signature	Payzoff generates signature for each transaction. Thus you may verify sender source. Concatenate those POST values in following order md5 hash: api_key + amount + transaction_id + secret_code + seller_transaction_id + signature_key	nfiTGXzzgPKv1jy2Aeoq9PYugZBWaLiIO2vZKJCl

Transaction status "Complete" in conjuncion with status_code "12" is final status and means successful payment.