FedEx Credential Registration Virtual Sandbox

Register and manage customer keys for FedEx API access.

The FedEx Credential Registration API allows developers to programmatically register and manage customer keys required for authenticating with FedEx services. This endpoint facilitates the onboarding process by enabling the secure generation of credentials needed to access the broader FedEx API ecosystem.

Use this hosted sandbox to simulate FedEx Credential Registration APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready. This keeps your integration code consistent across local development, QA, demos, and production.

Use cases:

Use this sandbox to validate customer key registration payloads, handle authentication token requests, verify error responses for invalid registration data, and test the initial handshake workflow required to onboard new applications into the FedEx environment.

FedEx Credential Registration virtual sandbox is up and running!

Use this sandbox URL as the API base in your code to simulate FedEx Credential Registration responses instantly.

`https://fedex-credential-registration.mock.beeceptor.com`

General

POST

/irc/v1/customerkeys

Compatible Providers can use this end point to generate Customer Key and Customer Secret for their customers. Customer Key and Customer Secret along with your API Key and Secret Key are required to generate OAuth token, which should be used in every API transaction. <br><br><i>Note: OAuth token

Query Parameter Name	Example
`appmode`	`sandbox,live`

Header Name	Example
`x-customer-transaction-id`	`"624deea6-b709-470c-8c39-4b5511281492"`
`content-type`*	`"application/json"`
`x-locale`	`"en_US"`
`authorization`*	`"Bearer XXX"`

Request Payload

{
  "accountNumber": "921607998",
  "address": {
    "city": "Nienowboro",
    "countryCode": "PW",
    "postalCode": "89894-0819",
    "residential": true,
    "stateOrProvinceCode": "MA",
    "streetLines": [
      "10 FedEx Parkway",
      "Suite 302"
    ]
  },
  "customerName": "Pedro Nitzsche"
}

Response Payload

{
  "output": {
    "alerts": [
      {
        "alertType": "WARNING",
        "code": "AUTH.INFO",
        "message": "Success",
        "parameterList": [
          {
            "key": "status",
            "value": "6uBx41k4"
          }
        ]
      },
      {
        "alertType": "WARNING",
        "code": "AUTH.SUCCESS",
        "message": "Success",
        "parameterList": [
          {
            "key": "environment",
            "value": "Fus8a2O4"
          },
          {
            "key": "status",
            "value": "tzxOQE3c"
          },
          {
            "key": "environment",
            "value": "rCJE12Sw"
          },
          {
            "key": "region",
            "value": "WSOXiTH2"
          },
          {
            "key": "status",
            "value": "J8VznGFd"
          }
        ]
      },
      {
        "alertType": "WARNING",
        "code": "AUTH.WARNING",
        "message": "Information",
        "parameterList": [
          {
            "key": "status",
            "value": "WvFpnoGa"
          }
        ]
      },
      {
        "alertType": "WARNING",
        "code": "AUTH.SUCCESS",
        "message": "Success",
        "parameterList": [
          {
            "key": "region",
            "value": "UpvsFtIF"
          },
          {
            "key": "retries",
            "value": "PhwvXndi"
          },
          {
            "key": "status",
            "value": "J4hSpYA5"
          }
        ]
      },
      {
        "alertType": "NOTE",
        "code": "AUTH.SUCCESS",
        "message": "Warning",
        "parameterList": [
          {
            "key": "retries",
            "value": "AZwtnDyG"
          },
          {
            "key": "retries",
            "value": "0XAQmRQt"
          }
        ]
      }
    ],
    "customerKey": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3ODI4NzIzMzcsImV4cCI6MTc4Mjg3ODkzNiwibmJmIjoxNzg2NjQ5NzA4LCJpc3MiOiJUdXJjb3R0ZSwgS2VybHVrZSBhbmQgUG93bG93c2tpIiwic3ViIjoiMjUwNGI4MDktZWI0My00MGM4LWFmYmItZjhmMzJkYTg3NTRjIiwiYXVkIjoiNDkwYTRmY2EtZmU5OS00MTQyLWJkMTgtOTNhMGQ4ZDllZmVjIiwianRpIjoiNDgwN2YxMjItNmI4Ni00ZDRhLThiYzEtMmJjY2E1MjQyMTc4In0.tN0sLzUMTPobQMiTAp0IUFUGU7J90VpzxB9qprKk7s5W826aSNl67t42MdAJxfN5",
    "customerPassword": "R5D4KhSuCkKW"
  },
  "transactionId": "356dc823-71d5-45f0-896c-b38905460a7d"
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "USER.ACCOUNT.NOTFOUND",
      "message": "Account Not Found in Database."
    }
  ]
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "NOT.AUTHORIZED.ERROR",
      "message": "Access token expired. Please modify your request and try again."
    }
  ]
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "FORBIDDEN.ERROR",
      "message": "We could not authorize your credentials. Please check your permissions and try again."
    }
  ]
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281482",
  "errors": [
    {
      "code": "NOT.FOUND.ERROR",
      "message": "The resource you requested is no longer available. Please modify your request and try again."
    }
  ]
}

{
  "transactionId": "624deea6-b709-470c-8c39-4b5511281492",
  "errors": [
    {
      "code": "INTERNAL.SERVER.ERROR",
      "message": "We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
    }
  ]
}

Service Homepage: developer.fedex.com/api/en-us/catalog/registration/v1/docs.html

fedexlogisticsauthenticationregistrationshipping