POST

Create Transaction


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

This endpoint is used to send a merchant's payment requests to a Payment Service Provider (PSP).

Wix calls this endpoint when a buyer chooses make a payment using the PSP on a merchant's Wix site. Learn more about implementing this endpoint.

Body Params
wixTransactionIdstringRequired

Wix transaction ID.


paymentMethodstring

Requested payment method. If the value of this field is creditCard, the paymentMethodData field's value includes credit card data in the value of the card field. A PSP can specify the payment methods they accept in the Wix Dev Ceter.


merchantCredentialsMap <string, string>Requiredformat map

Credentials that the PSP provided when the merchant connected their account.


orderOrderRequired

Order information.


modestring

Connection mode. Identifies whether a request is live or for testing purposes.


installmentsintegerformat int32

Number of payment installments requested.


wixMerchantIdstringRequired

Wix merchant ID.


paymentMethodDataPaymentMethodData

Payment method data such as credit card information.


fraudInformationFraudInformation

Fraud prevention data.


setupCredentialsOnFileSetupCredentialsOnFile

Data about recurring payment setup.


offSessionboolean

Whether the request is for a recurring payment or merchant initiated transaction. If the value of this field is true, the PSP should use a payment method token to process the payment. Learn more about recurring payments.


motoboolean

Whether the request is for a Mail Order/Telephone Order payment.


scaRequestedboolean

Request transaction uses strong customer authentication, such as 3-D Secure.


authorizeOnlyboolean

Whether to only authorize or to also immediately capture the transaction. If true, Wix sends requests to the PSP's Capture Transaction or Void Transaction endpoints to complete the transaction.
Default: false

Response Object
pluginTransactionIdstring

PSP transaction ID.


reasonCodeinteger

Wix reason code indicating a failed or pending request.


errorCodestring

PSP-specific error code.


errorMessagestring

PSP-specific error message.


redirectUrlstring

URL where Wix can redirect the buyer to complete the payment.


statusstringdeprecated

This field is deprecated.


credentialsOnFileCredentialsOnFile

Reference to a saved payment method.

Request
cURL
Response
JSON
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Did this help?