Carrier Management

Operaciones

Create UPS Ghost Account

Solicitud

Create a UPS shipper account on behalf of a merchant through ShipSaving, without requiring manual registration on the UPS website. The account is automatically linked to the merchant's ShipSaving company and ready for shipping label purchases.

Important: The address provided in this request will be used as the UPS default return address — e.g. packages returned to sender will be delivered to this address.

If an account with the same seller_id already exists, it will be soft-deleted and a new one will be created with the updated address. This allows merchants to change their return address by re-calling this endpoint.

Seguridad

BearerAuth or ApiTokenAuth

Cuerpoapplication/jsonrequerido

seller_idstringrequerido

Caller-defined unique identifier for a merchant or seller. Must be unique per UPS ghost account within the same company.

Ejemplo:"merchant_10042"

device_identitystring

Device fingerprint or identifier of the end user.

Ejemplo:"d8a7b6c5-e4f3-2a1b-9c8d-7e6f5a4b3c2d"

ip_addressstring, (ipv4)requerido

IP address of the end user.

Ejemplo:"203.0.113.42"

first_namestringrequerido

Shipper's first name.

Ejemplo:"John"

last_namestringrequerido

Shipper's last name.

Ejemplo:"Doe"

emailstring, (email)requerido

Shipper's email address.

Ejemplo:"john@example.com"

phonestringrequerido

Shipper's phone number.

Ejemplo:"2135551234"

companystring

Shipper's company name.

Ejemplo:"Acme Corp"

street1stringrequerido

First line of address. Accepts street address and PO boxes.

Ejemplo:"1600 Amphitheatre Parkway"

street2string

Second line of address (suite, room, floor, apartment, etc.).

Ejemplo:"Suite 200"

citystringrequerido

City name.

Ejemplo:"Mountain View"

statestringrequerido

Two-character state/province code (e.g., CA, MA).

Ejemplo:"CA"

postcodestring

Postal code.

Ejemplo:"94043"

countrystring(Country)requerido

Two-letter country code per ISO 3166-1 alpha-2.

Ejemplo:"US"

curl -i -X POST \
  https://ps-api.shipsaving.com/api/carrier/create_ups_ghost_account \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "seller_id": "merchant_10042",
    "device_identity": "d8a7b6c5-e4f3-2a1b-9c8d-7e6f5a4b3c2d",
    "ip_address": "203.0.113.42",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com",
    "phone": "2135551234",
    "company": "Acme Corp",
    "street1": "1600 Amphitheatre Parkway",
    "street2": "Suite 200",
    "city": "Mountain View",
    "state": "CA",
    "postcode": "94043",
    "country": "US"
  }'

Respuestas

UPS ghost account created successfully

Cuerpoapplication/json

seller_idstring

The merchant identifier provided in the request.

Ejemplo:"merchant_10042"

carrier_account_idstring

Carrier account token created in ShipSaving. Use this as the carrier_token in rate requests. This value can also be found in the ShipSaving system → Carrier Accounts page(the "Token" column in the list).

Ejemplo:"ca_bc28f2e7aaaa4bbbacccbf7d9f2c27xx"

shipper_account_numberstring

UPS shipper account number provisioned for this seller.

Ejemplo:"Y5XXXX"

Response

{
  "seller_id": "merchant_10042",
  "carrier_account_id": "ca_bc28f2e7aaaa4bbbacccbf7d9f2c27xx",
  "shipper_account_number": "Y5XXXX"
}