createTransaction - Amazon Selling Partner API (SP-API)-中文

从卖家钱包账户向客户提供的另一个账户创建交易请求。

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "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",
    "destinationAccountHolderAddress": {
        "addressLine1": "333 Boren Ave N",
        "city": "Seattle",
        "state": "WA",
        "postalCode": "98109",
        "countryCode": "US"
    },
    "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"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sellingpartnerapi-na.amazon.com/finances/transfers/wallet/2024-03-01/transactions?marketplaceId=A1RKKUPIHCS9HS' \
--header 'destAccountDigitalSignature: U8AsRXdh5fvjozFIv6vRUal1EHdFHhrCArIgmWbPtW0HuTlN_LPteg8G8tbvF4QmoRekOO84nQxg8j4gs0wEyAktg2Sm80a_FaTswv-U8XUXGHZ1UBagGD9zEPrGBbia_N5gm4fCOW-V3mSieblwBiUyq8frUYL606WtuStHtE3zJgaj9-B1ObhudxxQALuBKjPeksc7-qyrT8lwchdkiaprNwsqpv3aKid7Ux3uwEzxiEedO3QWvv6nCZnNNxK-zz2Zj6tPDE_mgQk5tJv4xRgMxtcTMmr7_ce4A9wqRxQqwBerIHpOIzpZizmXAG56uG8-hJojmPwnsPif7ihMuw' \
--header 'amountDigitalSignature: 1EHdFHhrCArIgmWbPtW0HuTlN_LPteg8G8tbvF4QmoRekOO84nQxg8j4gs0wEyAktg2Sm80a_FaTswv-U8XUXGHZ1UBagGD9zEPrGBbia_N5gm4fCOW-qyrT8lwchdkiaprNwsqpv3aKid7Ux3uwEzxiEedO3QWvv6nCZnNNxK-zz2Zj6tPDE_mgQk5tJv4xRgMxtcTMmr7' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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",
    "destinationAccountHolderAddress": {
        "addressLine1": "333 Boren Ave N",
        "city": "Seattle",
        "state": "WA",
        "postalCode": "98109",
        "countryCode": "US"
    },
    "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"
}'

返回响应

🟢200成功

application/json

成功

Headers

Body

示例

{
    "transaction": {
        "transactionId": "string",
        "transactionType": "CREDIT",
        "transactionStatus": "EXPIRED",
        "transactionRequestDate": "2019-08-24T14:15:22Z",
        "expectedCompletionDate": "2023-09-26T02:32:59.787Z",
        "transactionActualCompletionDate": "2019-08-24T14:15:22Z",
        "lastUpdateDate": "2019-08-24T14:15:22Z",
        "requesterName": "TPPOrgId",
        "transactionRequesterSource": "string",
        "transactionDescription": "string",
        "transactionSourceAccount": {
            "accountId": "string",
            "bankAccountHolderName": "string",
            "bankName": "string",
            "bankAccountNumberFormat": "IBAN",
            "bankAccountNumberTail": "string",
            "bankAccountCountryCode": "string",
            "bankAccountCurrency": "string"
        },
        "transactionDestinationAccount": {
            "accountId": "string",
            "bankAccountHolderName": "string",
            "bankName": "string",
            "bankAccountNumberFormat": "IBAN",
            "bankAccountNumberTail": "string",
            "bankAccountCountryCode": "string",
            "bankAccountCurrency": "string"
        },
        "transactionRequestAmount": {
            "currencyCode": "string",
            "currencyAmount": 0
        },
        "transferRateDetails": {
            "baseAmount": {
                "currencyCode": "string",
                "currencyAmount": 0
            },
            "fxRateDetails": {
                "fxRateId": "UNIQUE_FX_RATE_ID_1",
                "baseRate": 7.2,
                "effectiveFxRate": 7.25,
                "rateDirection": "BUY"
            },
            "transferAmount": {
                "currencyCode": "string",
                "currencyAmount": 0
            },
            "fees": [
                {
                    "feeId": "string",
                    "feeType": "MISCELLANEOUS_FEE",
                    "feeRateValue": "string",
                    "feeAmount": {
                        "currencyCode": "string",
                        "currencyAmount": 0
                    }
                }
            ]
        },
        "transactionFinalAmount": {
            "currencyCode": "string",
            "currencyAmount": 0
        },
        "transactionFailureReason": "Insufficient Balance"
    },
    "callBackURL": "https://www.example.com/callback/transaction_id/"
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠408408

🟠413413

🟠415415

🟠422参数错误

🟠429429

🔴500服务器错误

🔴503服务器故障