Skip to content

Customer number

/subscription_system/customer_number

Target audience: Developers

Sync customer

Introduction

Syncs the customer's subscriptions to match with those in the external subscription system. When performing bulk operations against this method you should do them in sequence and NOT in parallel.

URI

Environment URI
Stage https://payway-api.stage.adeprimo.se/external/api/v1/subscription_system/customer_number
Production https://backend.worldoftulo.com/external/api/v1/subscription_system/customer_number

Requirements

Identity Scope
No /external/subscription_system/w

Parameters

Field Required Type Description
account_id Required String The id of the account owning the user product.
Size range: ..24
Allowed values: "/^[a-f\d]{24}$/i"
customer_number Required String The customer number to set on the account.
Size range: ..50
Allowed values: "/^[a-zA-Z-_0-9]+$/"

Curl Example

curl --request PUT \
  --url https://payway-api.stage.adeprimo.se/external/api/v1/subscription_system/customer_number \
  --header 'accept: application/json' \
  --header 'authorization: Bearer token' \
  --header 'content-type: application/json' \
  --data '{
              "account_id": "56e1741a6fc9365306000002",
              "customer_number": "1234567890"
          }'

Response

Field Description
id The id of the updated account.

Example Response

HTTP 200 Updated
{
    "id": "50f3ac249f6aef294d000007"
}

Errors

Example error response

HTTP 400 Bad Request
{
    "code": "invalid_parameter",
    "field": "account_id",
    "message": "Parameter must match format (/^[a-f\d]{24}$/)"
}

HTTP 400 Bad Request

Name Type Description
invalid_parameter Object Validation error on any of the fields in the posted json
json_parser_error Object The request body could not be parsed as valid json
invalid_content_type_error Object The requests Content-Type header isn't set to application/json
unknown_parameter Object One or more of the fields in the posted json was not recognized

HTTP 404 Not Found

Name Type Description
not_found Object The account or product could not be found

HTTP 409 Conflict

Name Type Description
already_exists Object The customer number is already set on another account

HTTP 500 Internal Server Error

Name Type Description
internal_server_error Object Something unexpected happened server side