From Wiki.zanox.com
The payments RESTFul API resource enables the retrieval of the payment history of a publisher account.
GET: Retrieving a single payment item
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| paymentid
| mandatory
| path parameter
| the paymentId specifies the related payment item.
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments/payment/{paymentId}
// REST JSON
http://api.zanox.com/json/2009-07-01/payments/payment/{paymentId}
// REST XML using Header Authorization
GET xml/2009-07-01/payments/payment/{paymentId} HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<paymentItem id="612536475723">
<createdate>2008-01-01T00:00:00</createdate> //transdata
<modifydate>2008-01-01T00:00:00</modifydate> //updatedate
<payoutdate>2008-01-11T00:00:00</payoutdate> //payout
<status>confirmed</status>
<amount>100.00</amount>
<currency>EUR</currency>
<account id="">my bank account</account>
</paymentItem>
</response>
GET: Retrieving all payment items
|
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| items
| optional
| query parameter
| number of items in the result set [1..n] (default = 10; maximum = 50)
|
| page
| optional
| query parameter
| page position [0..n] (default: 0)
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments
// REST JSON
http://api.zanox.com/json/2009-07-01/payments
// REST XML using Header Authorization
GET xml/2009-07-01/payments HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<page>0</page>
<items>2</items>
<total>2</total>
<paymentItems>
<paymentItem id="07C0075C7650CF68">...</paymentItem>
<paymentItem id="83775VU823450OPQ">...</paymentItem>
</paymentItems>
</response>
GET: Retrieving a single balance item
|
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| currency
| mandatory
| path parameter
| to constrain the user balances for the given currency. Please abide by the ISO 4217 syntax. avaliable currencies
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments/balances/balance/EUR
// REST JSON
http://api.zanox.com/json/2009-07-01/payments/balances/balance/EUR
// REST XML using Header Authorization
GET xml/2009-07-01/payments/balances/balance/EUR HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<balanceItem id="EUR">
<open>150.00</open>
<confirmed>50.00</confirmed>
</balanceItem>
</response>
GET: Retrieving all balance items
|
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| items
| optional
| query parameter
| number of items in the result set [1..n] (default = 10; maximum = 50)
|
| page
| optional
| query parameter
| page position [0..n] (default: 0)
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments/balances
// REST JSON
http://api.zanox.com/json/2009-07-01/payments/balances
// REST XML using Header Authorization
GET xml/2009-07-01/payments/balances HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<page>0</page>
<items>2</items>
<total>2</total>
<balanceItems>
<balanceItem id="EUR">
<open>150.00</open>
<confirmed>50.00</confirmed>
</balanceItem>
<balanceItem id="USD">
<open>20.00</open>
<confirmed>10.00</confirmed>
</balanceItem>
</balanceItems>
</response>
GET: Retrieving a single bankAccount item
|
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| bankaccountid
| mandatory
| path parameter
| the bankaccountid specifies the related bankaccount item.
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments/bankaccounts/bankaccount/{bankaccountid}
// REST JSON
http://api.zanox.com/json/2009-07-01/payments/bankaccounts/bankaccount/{bankaccountid}
// REST XML using Header Authorization
GET xml/2009-07-01/payments/bankaccounts/bankaccount/{bankaccountid} HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<bankAccountItem id="702378946">
<profile>Standard</profile>
<iban>64003033</iban>
<swift>64003033</swift>
<bankcode>64003033</bankcode>
<accountnumber>12345678</accountnumber>
<accountholder>John Doe</accountholder>
<name>Deutsche Bank</name>
<address>Strasse Hausnummer, PLZ Stadt</address>
<country>DE</country>
<minpayout>25</minpayout>
</bankAccountItem>
</response>
GET: Retrieving all account items
|
| currently not supported
|
Parameters
| Name
| Necessity
| Parameter type
| Description
|
| connectid
| mandatory
| header or query parameter
| connectid is required for authorization to eliminate any possibility of data abuse.
|
| timestamp
| mandatory
| header or query parameter
| timestamp is required for authorization to eliminate any possibility of data abuse.
|
| nonce
| mandatory
| header or query parameter
| nonce is required for authorization to eliminate any possibility of data abuse.
|
| signature
| mandatory
| header or query parameter
| signature is required for authorization to eliminate any possibility of data abuse.
|
| items
| optional
| query parameter
| number of items in the result set [1..n] (default = 10; maximum = 50)
|
| page
| optional
| query parameter
| page position [0..n] (default: 0)
|
| callback
| optional
| query parameter
| Supported if format is JSON. Name of the JS function the result is wrapped in.
|
Example Request
// REST XML
http://api.zanox.com/xml/2009-07-01/payments/bankaccounts
// REST JSON
http://api.zanox.com/json/2009-07-01/payments/bankaccounts
// REST XML using Header Authorization
GET xml/2009-07-01/payments/bankaccounts HTTP/1.1
Host: api.zanox.com
Date: Mon, 09 Sep 2008 08:17:35 GMT
Authorization: ZXWS CE665464E0186EA44282
Example Response
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<response xmlns="http://api.zanox.com/namespace/2009-07-01/">
<page>0</page>
<items>2</items>
<total>2</total>
<bankAccountItems>
<bankAccountItem id="12fv123bv">...</bankAccountItem>
<bankAccountItem id="87234vf5g">...</bankAccountItem>
</bankAccountItems>
</response>
Explanation of the Response objects
- paymentItem
- bankAccountItem
- balanceItem
