Sign in

v1

latestOpenAPI 3.0.0Apache License 2.02026-07-263171,5614.1 MB
Seller Wallet v2024-03-01

createTransaction

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

post/finances/transfers/wallet/2024-03-01/transactions

Query parameters

marketplaceIdstring 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.

Headers

destAccountDigitalSignaturestring required

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

amountDigitalSignaturestring 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.

Request body

sourceAccountIdstring required

The unique identifier of the source Amazon Seller Wallet bank account from which the money is debited.

destinationAccountIdstring

The unique identifier of the destination bank account where the money is deposited.

transactionDescriptionstring

A description of the transaction.

customerPaymentReferencestring

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.

requestTimestring date-time required

The time at which the transaction was initiated in ISO 8601 date time format.

Example request

{
  "sourceAccountId": "amzn1.account.SMUGN2EN3ZHWSRJKH2KCJPII5JEI",
  "sourceAmount": {
    "amount": 100,
    "currency": "USD"
  },
  "destinationTransactionInstrument": {
    "bankAccount": {
      "bankAccountNumberFormat": "BBAN",
      "bankAccountOwnershipType": "SELF",
      "routingNumber": "HBUKGB4B",
      "bankNumberFormat": "BASIC",
      "accountCountryCode": "CN",
      "accountCurrency": "CNY",
      "bankAccountNumberTail": "819"
    },
    "accountHolderName": "John Doe",
    "bankAccountNumber": "GB29RBOS60161331926819"
  },
  "transactionDescription": "This is transaction to partner",
  "customerPaymentReference": "BG999999999",
  "payeeContactInformation": {
    "payeeFirstName": "John",
    "payeeLastName": "Doe",
    "payeeEntityType": "PERSON",
    "addressLine1": "Avenue John F. Kennedy 38",
    "city": "Luxembourg",
    "state": "LUXEMBOURG",
    "postalCode": "1855",
    "countryCode": "LU",
    "emailAddress": "johndoe@gmail.com",
    "phoneNumber": "3450987121"
  },
  "transferRateDetails": {
    "baseAmount": {
      "currencyCode": "EUR",
      "currencyAmount": 500
    },
    "fxRateDetails": {
      "fxRateId": "UNIQUE_FX_RATE_ID_1",
      "baseRate": 7.6915,
      "effectiveFxRate": 7.6084,
      "rateDirection": "BUY"
    },
    "transferAmount": {
      "currencyCode": "CNY",
      "currencyAmount": 3804.2
    },
    "fees": [
      {
        "feeId": "Unique_FeeId_001",
        "feeType": "TRANSACTION_FEE",
        "feeRateValue": "0.9",
        "feeAmount": {
          "currencyCode": "EUR",
          "currencyAmount": 4.5
        }
      },
      {
        "feeId": "Unique_FeeId_002",
        "feeType": "TAX",
        "feeRateValue": "20.0",
        "feeAmount": {
          "currencyCode": "EUR",
          "currencyAmount": 0.9
        }
      }
    ]
  },
  "requestTime": "2024-03-26T02:32:59.787Z"
}

Response

Success

callBackURLstring required

The callback URL for the transaction which the user have to click to approve/consent the transaction

Example response

{
  "callBackURL": "https://www.example.com/callback/transaction_id/"
}