createTransaction

post

https://sellingpartnerapi-eu.amazon.com/finances/transfers/wallet/2024-03-01/transactions

Create a transaction request from a Seller Wallet account to another customer-provided account.

Query Params

marketplaceId

string

required

The marketplace for which items are returned. The marketplace ID is the globally unique identifier of a marketplace. To find the ID for your marketplace, refer to Marketplace IDs.

Body Params

Defines the actual payload of the request

sourceAccountId

string

required

The unique identifier of the source Amazon SW bank account from where the money needs to be debited

destinationAccountId

string

Optional field to specify the unique identifier of the destination bank account where the money needs to be deposited

destinationTransactionInstrument

object

required

Request body to create transaction instrument, Amazon performs validation and screening (anti-money laundering measuers) on all the transaction instruments before executing a transaction thus it requires transaction instrument holder's contact details as well

transactionDescription

string

A description of the transaction.

customerPaymentReference

string

If the payment is for VAT (Value-Added-Tax) then enter VAT identification number in this field which will be mandatory. The length constraint is 140 characters and do not allow user to enter any sensitive information other than VAT-ID.

payeeContactInformation

object

The contact information of the payee. This field is required when the request bankAccountOwnershipType is THIRD_PARTY. The contact information is used for payee verification and registration purposes.

sourceAmount

object

required

A currency type and amount.

transferRateDetails

object

The fees and foreign exchange rates that apply to the transaction.

If the fees are in terms of the baseAmount (source account) currency, then the effective rate is equal to 1 - (fees * baseRate / baseAmount).

If the fees are in terms of the transferAmount (destination account) currency, then the effective rate is equal to baseRate - (fees / baseAmount).

In the preceding expressions, fees is equal to the sum of all feeAmount.currencyAmount values in the fees array.

requestTime

date-time

required

The transaction initiation request time in date-time format

Headers

destAccountDigitalSignature

string

required

Digital signature for the destination bank account details. For more information, refer to Third-Party Provider Signature Guidance.

amountDigitalSignature

string

required

Digital signature for the source currency transaction amount. Sign in the order of the request definitions. You can omit empty or optional fields. For more information, refer to Third-Party Provider Signature Guidance.

Responses

Language

Response

Choose an example:

application/json

200Success

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

408Request Timed Out.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

422The request was well-formed (i.e., syntactically correct) but could not be processed because of some restrictions like insufficient funds, transaction limit breach, etc.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.