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
    • The Recharge provider object
    • The Provider description object
    • The Product description object
    • The Recharge object
    • GETList mobile recharge providers
    • GETList mobile recharge provider descriptions
    • GETList mobile recharge product descriptions
    • GETList mobile recharges
    • POSTSend a mobile recharge
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec
Menu
  • Overview
Authentication process
  • Authentication
General
  • Shipments
  • Tracking
  • Services
Forwarder
  • Forwarder
Mobile Recharges
  • Mobile Recharges
    • The Recharge provider object
    • The Provider description object
    • The Product description object
    • The Recharge object
    • GETList mobile recharge providers
    • GETList mobile recharge provider descriptions
    • GETList mobile recharge product descriptions
    • GETList mobile recharges
    • POSTSend a mobile recharge
Account
  • Accounts
  • Account Addresses
  • Transactions
  • Add Funds
  • Add Sub Account
Download the OpenAPI spec

Mobile Recharges

Mobile recharges

  • GET/mobile-recharges/providers
  • GET/mobile-recharges/providers-descriptions
  • GET/mobile-recharges/products-descriptions
  • GET/mobile-recharges/recharges
  • POST/mobile-recharges/recharges

The Recharge provider object

Attributes

  • uidstring
  • namestring
  • externalCodestring
  • activeboolean | integer
  • createdAtstring <date-time>
  • updatedAtstring <date-time>
The Recharge provider object
1
2
3
4
5
6
{
  "uid": "z4n6xnnf3vtz",
  "name": "provider1xq",
  "externalCode": "PRV1XR",
  "active": 1
}

The Provider description object

Attributes

  • uidstring
  • displayNamestring
  • descriptionstring
  • localeIdnumber
  • providerIdnumber
  • createdAtstring <date-time>
  • updatedAtstring <date-time>

The Product description object

Attributes

  • uidstring
  • titlestring
  • descriptionMarkdownstring
  • extendedDescriptionMarkdownstring
  • localizationKeystring
  • productIdnumber
  • localeIdnumber
  • createdAtstring <date-time>
  • updatedAtstring <date-time>

The Recharge object

Attributes

  • uidstring
  • externalReferenceCodestringnullable
  • externalCustomerIdstringnullable
  • statusstring
  • amountnumber
  • pricenumber
  • notesstringnullable
  • scheduleDatestring <date-time>nullable
  • deliveredAtstring <date-time>nullable
  • accountIdnumber
  • countryIdnumber
  • rechargeableProductIdnumber
  • rechargeableProviderPromotionIdnumbernullable
  • labelIdnumbernullable
  • couponIdnumbernullable
  • createdAtstring <date-time>
  • updatedAtstring <date-time>
The Recharge object
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "uid": "kyzt3evwisxv",
  "externalReferenceCode": null,
  "externalCustomerId": null,
  "status": "awaiting_payment",
  "amount": 10,
  "price": 10,
  "notes": null,
  "scheduleDate": null,
  "deliveredAt": null,
  "countryId": 51,
  "rechargeableProductId": 1,
  "rechargeableProviderPromotionId": null,
  "labelId": null,
  "couponId": null
}

List mobile recharge providers

GET/mobile-recharges/providers
Requires an access token

Lists the mobile operators you can send a recharge to.

Query parameters

  • $limitnumber

    Maximum number of results.

    Default: 20
    >= 0 · <= 500

Header parameters

  • Accept-Languagestring

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

    Default: en-US

Responses

200

Successful operation

  • totalnumber
  • limitnumber
  • skipnumber
  • dataarray of Recharge provider
    The Recharge provider object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
GET/mobile-recharges/providers
1
2
curl 'https://sandbox.weshipyou.com/api/v1/mobile-recharges/providers' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "total": 1,
  "limit": 20,
  "skip": 0,
  "data": [
    {
      "uid": "z4n6xnnf3vtz",
      "name": "provider1xq",
      "externalCode": "PRV1XR",
      "active": 1
    }
  ]
}
Try itSend a real request to Test from this page. No code needed.

List mobile recharge provider descriptions

GET/mobile-recharges/providers-descriptions
Requires an access token

Lists the localized descriptions of the mobile operators.

Query parameters

  • $limitnumber

    Maximum number of results.

    Default: 20
    >= 0 · <= 500

Header parameters

  • Accept-Languagestring

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

    Default: en-US

Responses

200

Successful operation

  • totalnumber
  • limitnumber
  • skipnumber
  • dataarray of Provider description
    The Provider description object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
GET/mobile-recharges/providers-descriptions
1
2
curl 'https://sandbox.weshipyou.com/api/v1/mobile-recharges/providers-descriptions' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
{
  "total": 0,
  "limit": 20,
  "skip": 0,
  "data": []
}
Try itSend a real request to Test from this page. No code needed.

List mobile recharge product descriptions

GET/mobile-recharges/products-descriptions
Requires an access token

Lists the localized descriptions of the recharge products.

Query parameters

  • $limitnumber

    Maximum number of results.

    Default: 20
    >= 0 · <= 500

Header parameters

  • Accept-Languagestring

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

    Default: en-US

Responses

200

Successful operation

  • totalnumber
  • limitnumber
  • skipnumber
  • dataarray of Product description
    The Product description object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
GET/mobile-recharges/products-descriptions
1
2
curl 'https://sandbox.weshipyou.com/api/v1/mobile-recharges/products-descriptions' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
{
  "total": 0,
  "limit": 20,
  "skip": 0,
  "data": []
}
Try itSend a real request to Test from this page. No code needed.

List mobile recharges

GET/mobile-recharges/recharges
Requires an access token

Lists the mobile recharges of your accounts.

Query parameters

  • $limitnumber

    Maximum number of results.

    Default: 20
    >= 0 · <= 500

Header parameters

  • Accept-Languagestring

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

    Default: en-US

Responses

200

Successful operation

  • totalnumber
  • limitnumber
  • skipnumber
  • dataarray of Recharge
    The Recharge object
401

Missing or invalid access token

  • namestring
    Always NotAuthenticated
  • messagestring
  • codenumber
    Always 401
  • classNamestring
    Always not-authenticated
  • dataobject
GET/mobile-recharges/recharges
1
2
curl 'https://sandbox.weshipyou.com/api/v1/mobile-recharges/recharges' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"
Response
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "total": 1,
  "limit": 20,
  "skip": 0,
  "data": [
    {
      "uid": "kyzt3evwisxv",
      "externalReferenceCode": null,
      "externalCustomerId": null,
      "status": "awaiting_payment",
      "amount": 10,
      "price": 10,
      "notes": null,
      "scheduleDate": null,
      "deliveredAt": null,
      "countryId": 51,
      "rechargeableProductId": 1,
      "rechargeableProviderPromotionId": null,
      "labelId": null,
      "couponId": null
    }
  ]
}
Try itSend a real request to Test from this page. No code needed.

Send a mobile recharge

POST/mobile-recharges/recharges
Requires an access token

Orders a top-up for a phone, paid from your wallet balance (or your credit line). The recharge is sent to the operator at once and the response carries its status.

Query parameters

  • $limitnumber

    Maximum number of results.

    Default: 20
    >= 0 · <= 500

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.

  • paymentMethod"credit_line" | object

    How to pay. Omit it to pay from your wallet balance (add funds first with POST /add-funds); "credit_line" for accounts with a credit line.

    Child attributes
      One of
      Allowed values:credit_line
        • isWalletboolean
          Always true
      • accountUidstring

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

      • rechargeable_productobject
        Child attributes
        • idnumber
      • scheduleDatestring <date-time>nullable
      • amountnumber
      • account_rechargeable_contactobject
        Child attributes
        • namestring
        • accountNumberstring

      Responses

      201

      The recharge that was ordered.

      The Recharge object
      400

      The body is invalid, or the user cannot buy recharges yet (the account is disabled, the email or the phone number is not verified).

      • 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
      POST/mobile-recharges/recharges
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      curl -X POST 'https://sandbox.weshipyou.com/api/v1/mobile-recharges/recharges' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "accountUid": "45e3hygz8zkv",
  "rechargeable_product": {
    "id": 34
  },
  "amount": 20,
  "account_rechargeable_contact": {
    "name": "Maria Perez",
    "accountNumber": "+5352345678"
  }
}'
      Response
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      {
  "uid": "cb893zbz3h80",
  "externalReferenceCode": null,
  "externalCustomerId": null,
  "status": "delivered",
  "amount": 10,
  "price": 11.4,
  "scheduleDate": null,
  "deliveredAt": null,
  "countryId": 51,
  "rechargeableProductId": 1,
  "rechargeableProviderPromotionId": null,
  "labelId": 1,
  "couponId": null
}
      Try itSend a real request to Test from this page. No code needed.