Introduction

Welcome to the Buxter API client project.

The Buxter API client project provides open source Java and PHP clients for the Buxter transaction webservice in order to allow Facebook developers easy integration of Buxter into their own applications.

What is Buxter?

Buxter is a Facebook application which allows you to make social payments within the Facebook platform, e.g. to send/request money to/from your friends, to make donations or to pay for Facebook applications and virtual goods.

Buxter is backed by ClickandBuy, one of the leading payment systems on the internet with more than ten years experience in secure online payments processing.

To learn more about Buxter please have a look around in our project wiki and visit the following pages:

http://apps.facebook.com/mybuxter (Application)
http://buxter.com (Homepage with blog and further links)
http://www.facebook.com/mybuxter (Application page)

What is the Buxter API?

Buxter provides a simple but powerful API to give the merchants a possibility to process the secure payments via Buxter. Currently the are two possibilities to connect to the API:

SOAP:

Plain XML via HTTP using the same types as for SOAP:

CGI endpoint: https://buxter.clickandbuy.com/moneywallet/ds/api/1.0/http

SOAP (sandbox):

Plain XML via HTTP using the same types as for SOAP (sandbox):

CGI endpoint: https://wallet.clickandbuy-s1.com/moneywallet/ds/api/1.0/http

The CGI endpoint supports only the POST method, so you have to pass the parameter "q" with the value of XML request described in XSD. Here the example:

q=
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <CreateTransaction_Request xmlns="http://buxter.com/api/1.0/dom">
        <apiConfigurationID>1</apiConfigurationID>
        <requesterSignature>056FFEE123456756#069715F3E99E5EDED49715F3E99E7A63F318A1A6</requesterSignature>
        <amount>
            <amount>0.11</amount>
            <currency>EUR</currency>
        </amount>
        <title>Payment for the app XYZ</title>
        <description>Feature description</description>
        <buyerFbUserID>1234567890</buyerFbUserID>
        <returnURL>http://apps.facebook.com/yourapp?someparam=somevalue&amp;tx=$TXID$</returnURL>
        <externalID>1-750233393-13740147577013250</externalID>
    </CreateTransaction_Request>

As response you will get the following structure in HTTP response body:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <CreateTransaction_Response xmlns="http://buxter.com/api/1.0/dom">
        <transactionID>1234567890</transactionID>
        <transactionStatus>CREATED</transactionStatus>
        <externalID>1-750233393-13740147577013250</externalID>
        <redirectURL>http://apps.facebook.com/mybuxter/wallet/purchase?id=1234567890&amp;v=0BBE183D22F3D21E$40B45BF871DE312024E699AC7ECBF871DE312C76438D1FBC86</redirectURL>
    </CreateTransaction_Response>

For the general interaction overview see the blog article about Buxter architecture.

For all possible request, response and other complex data types see the well documented Buxter API vizualized via the WSDL viewer provided by Tomi Vanek (Thank you, Tomi!)

What is the Buxter API Client?

The Buxter API allows Facebook application developers to use the Buxter transaction webservice in Java or PHP to monetize their Facebook applications.

Buxter is offering a slim set of functions to securely

create purchase links
query the status of transactions
cancel transactions

which all can be used by the Buxter API client.

Discussion

We're using Google groups for discussion: http://groups.google.com/group/buxter-api/

Feel free to post if you...

...have any questions on how to use something within the Buxter API client
...have any suggestions on something that could be improved
...wish to make a contribution like ideas, code, etc.
...have comments about what you found useful or annoying in the Buxter API client project

Generally speaking, any interesting experiences with Buxter, the Buxter API client and related technical discussions are welcome. This is your chance to get direct feedback from the people who know Buxter and its API best.