Quick security check

Check the box so we know it’s really you.

Protected by Cloudflare. This keeps bots from creating fake accounts.

We Ship YouAnythingAnywhere
  • Shop
  • Mobile APP
  • Docs
  • Pricing
  • About Us
  • Shop
    • WeShipYou

      Shop curated products from WeShipYou sellers, fulfilled end-to-end with our shipping guarantee.

    • Amazon

      Shop on Amazon, the world's largest store with the widest range of products, all with the security of WeShipYou!

    • eBay

      New and used items from US sellers: we buy Buy It Now listings for you.

    • AliExpress

      Millions of products at factory prices, bought and shipped by us.

    • Walmart

      Shop pharmacy and grocery products at Walmart quickly and easily!

    • Shein

      Shop the latest trending products at the best discounted prices, only at the Shein store!

    • Temu

      Shop the best products at discounted prices at the Temu store!

    • Shopify

      Search thousands of US Shopify stores at once, or paste a link from any of them.

  • Download Mobile APP
    • FulfillmentNew

      Receiving, storage, same-day pick & pack, multi-carrier shipping and returns — handled by us.

    • Price comparator

      Compare and select the shipping service based on your interest fast and easy

    • Shop integrations

      Shopify app, public API and more — plug WeShipYou into your store.

    • API

      API Access for developers

    • Invoicing

      Automatic monthly invoices, branded PDFs and one-click payments.

  • Docs
  • Pricing
  • About us
  • Recharges to Mexico
  • Recharges to Colombia

Join our newsletter!

No spam, guaranteed.

Miami, FL — United States Warehouse

1940 NW 70th Ave, Miami, FL 33126

Get Directions
Follow us
GroupChannel
RechargesRecharge to MexicoRecharge to ColombiaRecharge to JamaicaRecharge to Nicaragua
ShippingSend a packageFulfillment serviceShop integrationsInvoicingShip to ColombiaShip to BrazilShip to MexicoLocker for Colombia
ResourcesDownload APPApiCommercial Assistance
CompanyAbout
Careers
Hiring
Become an AffiliateSupportContact us
Shop
WeShipYou
Amazon
eBay
AliExpress
Walmart
Shein
Temu
Shopify

WeShipYou is proud to be PCI-compliant certified, ensuring the highest standards of payment security and data protection

© We Ship You Corp. Terms of service · Privacy Policy · Legal

The WeShipYou logo and the name "WeShipYou" are registered trademarks of We Ship You Corp

Theme
WeShipYou
  • Overview
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
    • The Funds request object
    • POSTAdd funds to your wallet
  • Add Sub Account
Download the OpenAPI spec
Menu
  • Overview
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
Mobile Recharges
  • Mobile Recharges
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
    • The Funds request object
    • POSTAdd funds to your wallet
  • Add Sub Account
Download the OpenAPI spec

Add Funds

Add money to your wallet

  • POST/add-funds

The Funds request object

The wallet credit that was booked. Depending on the payment method the account is returned under result.account or account; a request that only registers a pending payment answers { "ok": true }.

Attributes

  • okboolean

    The payment was registered and will be credited once it is confirmed.

    Always true
  • resultobject
    Child attributes
    • accountAccount

      The account after the credit.

      Child attributes
      • namestringrequired
        at least 1 characters
      • displayNamestringrequired
        at least 1 characters
      • systemUnitsstringrequired
        Allowed values:imperialmetric
      • emailstringrequired
        at least 1 characters
      • notificationEmailstringrequired
        at least 1 characters
      • websitestringrequirednullable
      • phonestringrequirednullable
        at least 1 characters
      • emergencyPhonestringrequirednullable
        at least 1 characters
      • taxIdstringnullable
      • taxIdCountryobjectnullable
        Child attributes
        • isoCodestringrequired
      • uidstringread-only
      • accountNumberstringread-only
      • parentUidstringnullableread-only

        The uid of the parent account when this is a sub-account, null otherwise.

      • statusstringread-only
      • languagestringrequired
      • isBusinessboolean | integerrequired
      • allowBankAccountPaymentsboolean | integerread-only
      • metadataobjectnullableread-only
      • createdAtstring <date-time>read-only
      • updatedAtstring <date-time>read-only
      • deletedAtstring <date-time>nullableread-only
      • addressIdnumbernullableread-only
      • billingAddressIdnumbernullableread-only
      • defaultShipFromIdnumbernullableread-only
      • defaultAddressOnLabelIdnumbernullableread-only
      • defaultReturnAddressIdnumbernullableread-only
      • primaryPaymentShipmentsIdnumbernullableread-only
      • logoIdnumbernullableread-only
      • pickupServiceFallbackIdnumbernullableread-only
      • revisionnumbernullableread-only
      • addressAccount address | object

        Main address of the account.

        Child attributes
          One of
          • uidstringrequirednullable

            Address UID. Use it as accountAddressId, or as a sender / recipient uid on a shipment.

          • nicknamestringnullable

            Name shown in address books.

          • namestringnullable

            Contact name.

          • companyNamestringnullable

            Company name.

          • taxIdstringnullable

            Tax ID of the contact.

          • emailstringnullable

            Contact email.

          • phonestringnullable

            Contact phone, E.164.

          • birthdaystring <date-time>nullable

            Contact birthday, when collected.

          • isRecipientboolean | integernullable

            The address can receive shipments. 1/true or 0/false.

          • isSenderboolean | integernullable

            The address can send shipments. 1/true or 0/false.

          • isResidentialboolean | integernullable

            The address is residential. 1/true or 0/false.

          • statusstringrequirednullable

            Record status.

          • addressobjectnullable

            Street address. Included when the address is read on its own.

            Child attributes
            • cityobject
              Child attributes
              • namestringnullable
              • stateobject
                Child attributes
            • streetstring

              Street address, including the building or apartment number.

            • postalCodestring
          • countryobjectnullable

            Country of the address. Included when the address is read on its own.

            Child attributes
            • isoCodestring
              Allowed values:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
              exactly 2 characters
          • createdAtstring <date-time>requirednullable

            When the address was saved.

          • updatedAtstring <date-time>requirednullable

            When the address last changed.

      • accountAccount

        The account after the credit.

        Child attributes
        • namestringrequired
          at least 1 characters
        • displayNamestringrequired
          at least 1 characters
        • systemUnitsstringrequired
          Allowed values:imperialmetric
        • emailstringrequired
          at least 1 characters
        • notificationEmailstringrequired
          at least 1 characters
        • websitestringrequirednullable
        • phonestringrequirednullable
          at least 1 characters
        • emergencyPhonestringrequirednullable
          at least 1 characters
        • taxIdstringnullable
        • taxIdCountryobjectnullable
          Child attributes
          • isoCodestringrequired
        • uidstringread-only
        • accountNumberstringread-only
        • parentUidstringnullableread-only

          The uid of the parent account when this is a sub-account, null otherwise.

        • statusstringread-only
        • languagestringrequired
        • isBusinessboolean | integerrequired
        • allowBankAccountPaymentsboolean | integerread-only
        • metadataobjectnullableread-only
        • createdAtstring <date-time>read-only
        • updatedAtstring <date-time>read-only
        • deletedAtstring <date-time>nullableread-only
        • addressIdnumbernullableread-only
        • billingAddressIdnumbernullableread-only
        • defaultShipFromIdnumbernullableread-only
        • defaultAddressOnLabelIdnumbernullableread-only
        • defaultReturnAddressIdnumbernullableread-only
        • primaryPaymentShipmentsIdnumbernullableread-only
        • logoIdnumbernullableread-only
        • pickupServiceFallbackIdnumbernullableread-only
        • revisionnumbernullableread-only
        • addressAccount address | object

          Main address of the account.

          Child attributes
            One of
            • uidstringrequirednullable

              Address UID. Use it as accountAddressId, or as a sender / recipient uid on a shipment.

            • nicknamestringnullable

              Name shown in address books.

            • namestringnullable

              Contact name.

            • companyNamestringnullable

              Company name.

            • taxIdstringnullable

              Tax ID of the contact.

            • emailstringnullable

              Contact email.

            • phonestringnullable

              Contact phone, E.164.

            • birthdaystring <date-time>nullable

              Contact birthday, when collected.

            • isRecipientboolean | integernullable

              The address can receive shipments. 1/true or 0/false.

            • isSenderboolean | integernullable

              The address can send shipments. 1/true or 0/false.

            • isResidentialboolean | integernullable

              The address is residential. 1/true or 0/false.

            • statusstringrequirednullable

              Record status.

            • addressobjectnullable

              Street address. Included when the address is read on its own.

              Child attributes
              • cityobject
                Child attributes
                • namestringnullable
                • stateobject
                  Child attributes
                  • namestringnullable
              • streetstring

                Street address, including the building or apartment number.

              • postalCodestring
            • countryobjectnullable

              Country of the address. Included when the address is read on its own.

              Child attributes
              • isoCodestring
                Allowed values:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
                exactly 2 characters
            • createdAtstring <date-time>requirednullable

              When the address was saved.

            • updatedAtstring <date-time>requirednullable

              When the address last changed.

          • transactionTransaction

            The wallet credit.

            Child attributes
            • idnumber <int64>read-only

              Internal ID of the transaction.

            • uidstringread-only

              Transaction UID.

            • typestring

              credit (money in) or debit (money out).

              Allowed values:debitcreditrefund
              at least 1 characters
            • transTypestring

              What the transaction is for, for example Payment, Shipment or Recharge.

              Allowed values:ShipmentPaymentMoney TransferAdjustmenFee
              at least 1 characters
            • statestring

              Settlement state, for example cleared or pending.

              Allowed values:clearedpending
              at least 1 characters
            • referenceNostring

              Reference number of the payment or service.

              at least 1 characters
            • descriptionstring

              Description of the transaction.

              at least 1 characters
            • courierNamestringnullable

              Carrier of the shipment, for shipment charges.

              at least 1 characters
            • amountnumber

              Amount, USD.

              at least 1 characters
            • balancenumber

              Wallet balance after this transaction, USD.

              at least 1 characters
            • accountIdnumber

              Internal ID of the account the transaction belongs to.

              at least 1 characters
            • adjustmentTypeIdnumbernullable

              Internal ID of the adjustment, for manual adjustments.

              at least 1 characters
            • createdAtstring <date-time>

              When the transaction was booked.

              at least 1 characters
            • updatedAtstring <date-time>

              When the transaction last changed.

              at least 1 characters
          • transactionFeeTransaction

            The processing fee charged for the payment, when there is one.

            Child attributes
            • idnumber <int64>read-only

              Internal ID of the transaction.

            • uidstringread-only

              Transaction UID.

            • typestring

              credit (money in) or debit (money out).

              Allowed values:debitcreditrefund
              at least 1 characters
            • transTypestring

              What the transaction is for, for example Payment, Shipment or Recharge.

              Allowed values:ShipmentPaymentMoney TransferAdjustmenFee
              at least 1 characters
            • statestring

              Settlement state, for example cleared or pending.

              Allowed values:clearedpending
              at least 1 characters
            • referenceNostring

              Reference number of the payment or service.

              at least 1 characters
            • descriptionstring

              Description of the transaction.

              at least 1 characters
            • courierNamestringnullable

              Carrier of the shipment, for shipment charges.

              at least 1 characters
            • amountnumber

              Amount, USD.

              at least 1 characters
            • balancenumber

              Wallet balance after this transaction, USD.

              at least 1 characters
            • accountIdnumber

              Internal ID of the account the transaction belongs to.

              at least 1 characters
            • adjustmentTypeIdnumbernullable

              Internal ID of the adjustment, for manual adjustments.

              at least 1 characters
            • createdAtstring <date-time>

              When the transaction was booked.

              at least 1 characters
            • updatedAtstring <date-time>

              When the transaction last changed.

              at least 1 characters
          The Funds request object
          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          12
          13
          14
          15
          16
          17
          18
          19
          20
          21
          22
          23
          24
          25
          26
          27
          28
          29
          30
          31
          32
          33
          34
          35
          36
          37
          38
          39
          40
          41
          42
          43
          44
          45
          46
          47
          48
          {
  "result": {
    "account": {
      "name": "Acme Imports",
      "displayName": "Acme Imports",
      "systemUnits": "metric",
      "email": "jane.doe@example.com",
      "notificationEmail": "jane.doe@example.com",
      "website": null,
      "phone": null,
      "emergencyPhone": null,
      "taxId": null,
      "uid": "un0xo9497f7d",
      "accountNumber": "000ACC1X12",
      "status": "active",
      "language": "en",
      "isBusiness": false,
      "allowBankAccountPayments": false,
      "metadata": null,
      "createdAt": "2026-11-01T00:37:54.000Z",
      "updatedAt": "2026-11-01T00:37:54.000Z",
      "deletedAt": null,
      "addressId": null,
      "billingAddressId": null,
      "defaultShipFromId": null,
      "defaultAddressOnLabelId": null,
      "defaultReturnAddressId": null,
      "primaryPaymentShipmentsId": null,
      "logoId": null,
      "pickupServiceFallbackId": null,
      "revision": 1
    }
  },
  "transaction": {
    "id": 1,
    "uid": "f3g35lk6rf5vd7550fp31w3ua595nr2l4ce6",
    "type": "credit",
    "transType": "Payment",
    "state": "cleared",
    "referenceNo": "PNQB9YCJIUS",
    "description": "Payment from API (add credit) - crypto deposit",
    "amount": 30,
    "balance": 30,
    "accountId": 1,
    "createdAt": "2026-11-01T00:37:54.652Z",
    "updatedAt": "2026-11-01T00:37:54.652Z"
  }
}

          Add funds to your wallet

          POST/add-funds
          Requires an access token

          Adds money to your wallet. With zelle the payment is registered and credited once WeShipYou confirms it; with crypto the paid Coinbase charge is credited at once.

          Header parameters

          • Accept-Languagestring

            Two-letter code of the language for messages: en, es or pt.

            Default: en-US

          Request bodyapplication/json

          The shipment to create.

          • paymentMethodstring

            How you paid: zelle (the default) or crypto.

            Allowed values:zellecrypto
            Default: zelle
          • accountUidstring

            The account uid. Optional when you belong to a single account.

          • transactionobject
            Child attributes
            • zelleTransactionstring

              The Zelle transaction ID, for zelle.

            • amountnumber

              Amount you sent, USD. Required for zelle and crypto.

            • chargeUidstring

              The code of the paid Coinbase Commerce charge, for crypto.

          Responses

          201

          Successful operation

          The Funds request object
          400

          Invalid request

          • namestring
            Always BadRequest
          • messagestring
          • codenumber
            Always 400
          • classNamestring
            Always bad-request
          • dataobject
          401

          Missing or invalid access token

          • namestring
            Always NotAuthenticated
          • messagestring
          • codenumber
            Always 401
          • classNamestring
            Always not-authenticated
          • dataobject
          404

          The payment was not found

          • namestring
            Always NotFound
          • messagestring
          • codenumber
            Always 404
          • classNamestring
            Always not-found
          • dataobject
          POST/add-funds
          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          curl -X POST 'https://sandbox.weshipyou.com/api/v1/add-funds' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "paymentMethod": "zelle",
  "accountUid": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "transaction": {
    "zelleTransaction": "ZL-20261001-0001",
    "amount": 20
  }
}'
          Response
          1
          2
          3
          4
          5
          6
          7
          8
          9
          10
          11
          12
          13
          14
          15
          16
          17
          18
          19
          20
          21
          22
          23
          24
          25
          26
          27
          28
          29
          30
          31
          32
          33
          34
          35
          36
          37
          38
          39
          40
          41
          42
          43
          44
          45
          46
          47
          48
          {
  "result": {
    "account": {
      "name": "Acme Imports",
      "displayName": "Acme Imports",
      "systemUnits": "metric",
      "email": "jane.doe@example.com",
      "notificationEmail": "jane.doe@example.com",
      "website": null,
      "phone": null,
      "emergencyPhone": null,
      "taxId": null,
      "uid": "un0xo9497f7d",
      "accountNumber": "000ACC1X12",
      "status": "active",
      "language": "en",
      "isBusiness": false,
      "allowBankAccountPayments": false,
      "metadata": null,
      "createdAt": "2026-11-01T00:37:54.000Z",
      "updatedAt": "2026-11-01T00:37:54.000Z",
      "deletedAt": null,
      "addressId": null,
      "billingAddressId": null,
      "defaultShipFromId": null,
      "defaultAddressOnLabelId": null,
      "defaultReturnAddressId": null,
      "primaryPaymentShipmentsId": null,
      "logoId": null,
      "pickupServiceFallbackId": null,
      "revision": 1
    }
  },
  "transaction": {
    "id": 1,
    "uid": "f3g35lk6rf5vd7550fp31w3ua595nr2l4ce6",
    "type": "credit",
    "transType": "Payment",
    "state": "cleared",
    "referenceNo": "PNQB9YCJIUS",
    "description": "Payment from API (add credit) - crypto deposit",
    "amount": 30,
    "balance": 30,
    "accountId": 1,
    "createdAt": "2026-11-01T00:37:54.652Z",
    "updatedAt": "2026-11-01T00:37:54.652Z"
  }
}
          Try itSend a real request to Test from this page. No code needed.