Buxter Wiki / SOAPCreateTransaction
View
 

SOAPCreateTransaction

Go back to the Buxter API here.

 

This operation creates a new Buxter transaction.

 

Preconditions for obtaining a valid transaction are specified in the merchant limits and are checked each time this call is invoked.

 

Postconditions for a valid purchase are defined in the user limits and are checked after the User is redirected to the Buxter Wallet on his Facebook Account.

 

Operation Type Request-response. The endpoint receives a message, and sends a correlated message.
SOAP Action http://buxter.com/api/1.0/CreateTransaction
Input

CreateTransactionRequest (soap:body, use = literal)

 

A type containing all information needed to create a financial transaction in the Buxter system.

 

 

request type CreateTransaction_Request  
Parameters    

apiConfigurationID

type long

a long representing an unique identifier of an application in the Buxter system 

requesterSignature

type Signature

string with maxLength(255)

 

A string representing a signature of the requester, calculated with the shared secret key. 

amount

type Money

 

Money type containing amount and currency

 

amount: a string representing amount in main currency unit and a fractional currency (e.g. 1.25, 0.45) separated by a dot

 

currency: a string representing currency as ISO 4217 currency code (e.g. 'USD', 'EUR')

amount type Amount  string with restriction pattern([0-9]{1,16}([.][0-9]{1,3})?) whiteSpace(collapse)
currency type SupportedCurrency string with restriction length(3) whiteSpace(collapse)

 

title  type TitleString   

string with restriction maxLength(255) 

 

The title of the transaction

description  optional; type TitleString  

string with restriction maxLength(255) 

 

Any additional description of the transaction

buyerFbUserID type long The Facebook user id of the buyer 
returnURL optional; type anyURI The URL to which the buyer will be redirected after the transaction is successfully completed. 
externalID type ExternalID

string with restriction maxLength(255) 

 

A string representing an identifier of the transaction in an external system (e.g. in the seller's database), which must be unique for the given apiConfigurationID. 

 

Please note that externalIDs that are used twice will not be accepted.

 

 

 

Output 

CreateTransactionResponse (soap:body, use = literal)

 

response type

CreateTransaction_Response; 

extension of type TransactionInfo

 
Parameters    
transactionID type long A unique identifier of the transaction in the Buxter system as returned in the CreateTransaction_Response
transactionStatus type TransactionStatus

string with restriction - enum { 'CREATED', 'PENDING_CONFIRMATION', 'PENDING_PAYMENT', 'SUCCESS', 'DECLINED', 'ABORTED', 'CANCELLED', 'EXPIRED', 'CHARGEDBACK', 'BOOKED_OUT', 'BOOKED_IN', 'INSUFFICIENT_FUNDS' }

 

A string representing current status of the transaction e.g. CREATED or CANCELLED

externalID type ExternalID

string with restriction maxLength(255)

 

A string representing an identifier of the transaction in an external system (e.g. in the seller's database) as specified by the requester in the transaction request 

redirectURL optional; type anyURI A string representing an URI where a buyer will be redirected after a successful transaction

 

Fault

ErrorResponse (soap:fault)

 

exception type

Error_Response

 

type containing informations returned in case of an error
Parameters    
name type ErrorName

A string with restriction - enum { 'MalformedRequest', 'InvalidRequest', 'AuthenticationFailed', 'TechnicalError' }

 

An enumeration representing the error name

detail type ErrorDetail

A string with restriction - enum { 'MalformedRequest', 'EmptyRequest', 'UnknownRequest', 'InvalidRequest', 'InvalidAPIConfigurationID', 'APIConfigurationNotActive', 'APIConfigurationLocked', 'DuplicateExternalID', 'LimitsExceeded', 'TransactionNotFound', 'TransactionNotCancellable', 'AuthenticationFailed', 'InvalidSignature', 'TechnicalError' }

 

A string representing a more detailed description of the error Please note that the content of the description field is meant for human interpretation, it's contents may change at any time for a given error scenario.

 

 

 

Comments (0)

You don't have permission to comment on this page.