CyberSource Customer Shipping Address API
A Customer Shipping Address is linked to a Customer. It stores shipping information in relation to the Customer.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cybersource-customer-shipping-address-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: All CyberSource API specs merged together. These are available at https://developer.cybersource.com/api/reference/api-reference.html
version: 0.0.1
title: CyberSource Merged Spec bankAccountValidation Customer Shipping Address API
servers:
- url: https://apitest.cybersource.com/
tags:
- name: Customer Shipping Address
description: 'A Customer Shipping Address is linked to a Customer.
It stores shipping information in relation to the Customer.
'
paths:
/tms/v2/customers/{customerId}/shipping-addresses:
post:
summary: Create a Customer Shipping Address
description: '| | | |
| --- | --- | --- |
|**Customer Shipping Address**<br>A Customer Shipping Address represents tokenized customer shipping information.<br>A [Customer](#token-management_customer_create-a-customer) can have [one or more Shipping Addresses](#token-management_customer-shipping-address_list-shipping-addresses-for-a-customer), with one allocated as the Customers default for use in payments.| |**Creating a Customer Shipping Address**<br>Your system can use this API to create an existing Customers default or non default Shipping Address.<br>You can also create additional Customer Shipping Addresses via the [Payments API](#payments_payments_process-a-payment_samplerequests-dropdown_authorization-with-token-create_authorization-create-default-payment-instrument-shipping-address-for-existing-customer_liveconsole-tab-request-body).
'
parameters:
- name: profile-id
in: header
description: The Id of a profile containing user specific TMS configuration.
required: false
x-hide-field: true
schema:
type: string
maxLength: 36
minLength: 36
- name: customerId
in: path
description: The Id of a Customer.
required: true
schema:
type: string
maxLength: 32
minLength: 1
tags:
- Customer Shipping Address
operationId: postCustomerShippingAddress
x-devcenter-metaData:
categoryTag: Token_Management
developerGuides: https://developer.cybersource.com/docs/cybs/en-us/tms/developer/all/rest/tms/tms-cust-tkn/tms-ship-tkn/tms-ship-addr-tkn-create-intro.html
mleForRequest: optional
x-depends:
example:
path: /tms/v2/customers/{customerId}
verb: post
exampleId: example0
fieldMapping:
- sourceField: id
destinationField: customerId
fieldTypeInDestination: path
responses:
'201':
description: A new Shipping Address has been created.
headers:
Location:
description: Location of the Shipping Address.
schema:
type: string
ETag:
description: An ETag is an identifier assigned to a specific version of a resource.
schema:
type: string
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally-unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
properties:
_links:
type: object
readOnly: true
properties:
self:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customers Shipping Address
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses/D9F3439F0448C901E053A2598D0AA1CC
customer:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customer
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3
id:
type: string
minLength: 1
maxLength: 32
description: The Id of the Shipping Address Token.
default:
type: boolean
description: "Flag that indicates whether customer shipping address is the dafault.\nPossible Values:\n - `true`: Shipping Address is customer's default.\n - `false`: Shipping Address is not customer's default.\n"
shipTo:
type: object
properties:
firstName:
type: string
maxLength: 60
description: 'First name of the recipient.
'
lastName:
type: string
maxLength: 60
description: 'Last name of the recipient.
'
company:
type: string
maxLength: 60
description: 'Company associated with the shipping address.
'
address1:
type: string
maxLength: 60
description: 'First line of the shipping address.
'
address2:
type: string
maxLength: 60
description: 'Second line of the shipping address.
'
locality:
type: string
maxLength: 50
description: 'City of the shipping address.
'
administrativeArea:
type: string
maxLength: 20
description: 'State or province of the shipping address. Use 2 character the State,
Province, and Territory Codes for the United States and Canada.
'
postalCode:
type: string
maxLength: 10
description: 'Postal code for the shipping address. The postal code must consist of 5 to 9 digits.
When the billing country is the U.S., the 9-digit postal code must follow this format:
[5 digits][dash][4 digits]
Example 12345-6789
When the billing country is Canada, the 6-digit postal code must follow this format:
[alpha][numeric][alpha][space][numeric][alpha][numeric]
Example A1B 2C3
**American Express Direct**\
Before sending the postal code to the processor, all nonalphanumeric characters are removed and, if the
remaining value is longer than nine characters, truncates the value starting from the right side.
'
country:
type: string
description: 'Country of the shipping address. Use the two-character ISO Standard Country Codes.
'
maxLength: 2
email:
type: string
maxLength: 320
description: 'Email associated with the shipping address.
'
phoneNumber:
type: string
maxLength: 15
description: 'Phone number associated with the shipping address.
'
metadata:
type: object
readOnly: true
properties:
creator:
type: string
readOnly: true
description: The creator of the Shipping Address.
'400':
description: 'Bad Request: e.g. A required header value could be missing.'
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
readOnly: true
properties:
errors:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
type:
type: string
readOnly: true
description: "The type of error.\n\nPossible Values:\n - invalidHeaders\n - missingHeaders\n - invalidFields\n - missingFields\n - unsupportedPaymentMethodModification\n - invalidCombination\n"
message:
type: string
readOnly: true
description: The detailed message related to the type.
details:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
name:
type: string
readOnly: true
description: The name of the field that caused the error.
location:
type: string
readOnly: true
description: The location of the field that caused the error.
'403':
description: 'Forbidden: e.g. The profile might not have permission to perform the operation.'
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
readOnly: true
properties:
errors:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
type:
type: string
readOnly: true
description: "The type of error.\n\nPossible Values:\n - forbidden\n - declined\n"
message:
type: string
readOnly: true
description: The detailed message related to the type.
'409':
description: Conflict. The token is linked to a Payment Instrument.
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
readOnly: true
properties:
errors:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
type:
type: string
readOnly: true
description: "The type of error.\n\nPossible Values:\n - instrumentIdentifierDeletionError\n - tokenIdConflict\n - conflict\n"
message:
type: string
readOnly: true
description: The detailed message related to the type.
'424':
description: 'Failed Dependency: e.g. The profile represented by the profile-id may not exist or the profile-id was entered incorrectly.'
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
readOnly: true
properties:
errors:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
type:
type: string
readOnly: true
description: "The type of error.\n\nPossible Values:\n - notFound\n"
message:
type: string
readOnly: true
description: The detailed message related to the type.
'500':
description: Unexpected error.
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally unique Id associated with your request.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
type: object
readOnly: true
properties:
errors:
type: array
readOnly: true
items:
type: object
readOnly: true
properties:
type:
type: string
readOnly: true
description: "The type of error.\n\nPossible Values:\n - internalError\n"
message:
type: string
readOnly: true
description: The detailed message related to the type.
x-example:
example0:
summary: Create Customer Default Shipping Address
value:
default: 'true'
shipTo:
firstName: John
lastName: Doe
company: CyberSource
address1: 1 Market St
locality: San Francisco
administrativeArea: CA
postalCode: '94105'
country: US
email: test@cybs.com
phoneNumber: '4158880000'
example1:
summary: Create Customer Non-Default Shipping Address
value:
default: 'false'
shipTo:
firstName: John
lastName: Doe
company: CyberSource
address1: 1 Market St
locality: San Francisco
administrativeArea: CA
postalCode: '94105'
country: US
email: test@cybs.com
phoneNumber: '4158880000'
requestBody:
content:
application/json;charset=utf-8:
schema:
type: object
properties:
_links:
type: object
readOnly: true
properties:
self:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customers Shipping Address
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses/D9F3439F0448C901E053A2598D0AA1CC
customer:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customer
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3
id:
type: string
minLength: 1
maxLength: 32
description: The Id of the Shipping Address Token.
default:
type: boolean
description: "Flag that indicates whether customer shipping address is the dafault.\nPossible Values:\n - `true`: Shipping Address is customer's default.\n - `false`: Shipping Address is not customer's default.\n"
shipTo:
type: object
properties:
firstName:
type: string
maxLength: 60
description: 'First name of the recipient.
'
lastName:
type: string
maxLength: 60
description: 'Last name of the recipient.
'
company:
type: string
maxLength: 60
description: 'Company associated with the shipping address.
'
address1:
type: string
maxLength: 60
description: 'First line of the shipping address.
'
address2:
type: string
maxLength: 60
description: 'Second line of the shipping address.
'
locality:
type: string
maxLength: 50
description: 'City of the shipping address.
'
administrativeArea:
type: string
maxLength: 20
description: 'State or province of the shipping address. Use 2 character the State,
Province, and Territory Codes for the United States and Canada.
'
postalCode:
type: string
maxLength: 10
description: 'Postal code for the shipping address. The postal code must consist of 5 to 9 digits.
When the billing country is the U.S., the 9-digit postal code must follow this format:
[5 digits][dash][4 digits]
Example 12345-6789
When the billing country is Canada, the 6-digit postal code must follow this format:
[alpha][numeric][alpha][space][numeric][alpha][numeric]
Example A1B 2C3
**American Express Direct**\
Before sending the postal code to the processor, all nonalphanumeric characters are removed and, if the
remaining value is longer than nine characters, truncates the value starting from the right side.
'
country:
type: string
description: 'Country of the shipping address. Use the two-character ISO Standard Country Codes.
'
maxLength: 2
email:
type: string
maxLength: 320
description: 'Email associated with the shipping address.
'
phoneNumber:
type: string
maxLength: 15
description: 'Phone number associated with the shipping address.
'
metadata:
type: object
readOnly: true
properties:
creator:
type: string
readOnly: true
description: The creator of the Shipping Address.
required: true
get:
summary: List Shipping Addresses for a Customer
description: '| | | |
| --- | --- | --- |
|**Customer Shipping Address**<br>A Customer Shipping Address represents tokenized customer shipping information.<br>A [Customer](#token-management_customer_create-a-customer) can have [one or more Shipping Addresses](#token-management_customer-shipping-address_list-shipping-addresses-for-a-customer), with one allocated as the Customers default for use in payments.| |**Retrieving all Customer Shipping Addresses**<br>Your system can use this API to retrieve all existing Shipping Addresses for a Customer.
'
parameters:
- name: profile-id
in: header
description: The Id of a profile containing user specific TMS configuration.
required: false
x-hide-field: true
schema:
type: string
maxLength: 36
minLength: 36
- name: customerId
in: path
description: The Id of a Customer.
required: true
schema:
type: string
maxLength: 32
minLength: 1
- name: offset
in: query
description: Starting record in zero-based dataset that should be returned as the first object in the array. Default is 0.
required: false
schema:
type: integer
format: int64
default: 0
minimum: 0
- name: limit
in: query
description: The maximum number that can be returned in the array starting from the offset record in zero-based dataset. Default is 20, maximum is 100.
required: false
schema:
type: integer
format: int64
default: 20
maximum: 100
minimum: 1
tags:
- Customer Shipping Address
operationId: getCustomerShippingAddressesList
x-devcenter-metaData:
categoryTag: Token_Management
developerGuides: https://developer.cybersource.com/docs/cybs/en-us/tms/developer/all/rest/tms/tms-cust-tkn/tms-ship-tkn/tms-ship-addr-tkn-retrieve-all-intro.html
x-depends:
example:
path: /tms/v2/customers/{customerId}
verb: post
exampleId: example0
fieldMapping:
- sourceField: id
destinationField: customerId
fieldTypeInDestination: path
responses:
'200':
description: Returns all existing Shipping Addresses associated with the supplied Id.
headers:
v-c-correlation-id:
description: The mandatory correlation Id passed by upstream (calling) system.
schema:
type: string
uniqueTransactionID:
description: A globally-unique Id associated with your request.
schema:
type: string
X-Total-Count:
description: The total number of Shipping Addresses associated with the Customer.
schema:
type: string
content:
application/json;charset=utf-8:
schema:
title: ShippingAddressListForCustomer
type: object
readOnly: true
description: 'A paginated container of Shipping Addresses.
'
properties:
_links:
type: object
readOnly: true
properties:
self:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the current page.
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses?offset=0&limit=1
first:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the first page.
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses?offset=0&limit=1
prev:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the previous page.
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses?offset=0&limit=1
next:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the next page.
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses?offset=0&limit=1
last:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the last page.
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses?offset=0&limit=1
offset:
type: integer
readOnly: true
default: 0
example: 0
description: The offset parameter supplied in the request.
limit:
type: integer
readOnly: true
default: 20
example: 20
description: The limit parameter supplied in the request.
count:
type: integer
readOnly: true
example: 1
description: The number of Shipping Addresses returned in the array.
total:
type: integer
readOnly: true
example: 1
description: The total number of Shipping Addresses associated with the Customer.
_embedded:
type: object
readOnly: true
description: 'Shipping Address Resources.
'
properties:
shippingAddresses:
type: array
readOnly: true
items:
type: object
properties:
_links:
type: object
readOnly: true
properties:
self:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customers Shipping Address
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3/shipping-addresses/D9F3439F0448C901E053A2598D0AA1CC
customer:
type: object
readOnly: true
properties:
href:
type: string
readOnly: true
description: 'Link to the Customer
'
example: /tms/v2/customers/D9F340DD3DB9C276E053A2598D0A41A3
id:
type: string
minLength: 1
maxLength: 32
description: The Id of the Shipping Address Token.
default:
type: boolean
description: "Flag that indicates whether customer shipping address is the dafault.\nPossible Values:\n - `true`: Shipping Address is customer's default.\n - `false`: Shipping Address is not customer's default.\n"
shipTo:
type: object
properties:
firstName:
type: string
maxLength: 60
description: 'First name of the recipient.
'
lastName:
type: string
maxLength: 60
description: 'Last name of the recipient.
'
company:
type: string
maxLength: 60
description: 'Company associated with the shipping address.
'
address1:
type: string
maxLength: 60
description: 'First line of the shipping address.
'
address2:
type: string
maxLength: 60
# --- truncated at 32 KB (106 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cybersource/refs/heads/main/openapi/cybersource-customer-shipping-address-api-openapi.yml