Set a cardholder's billing or delivery address
/v1/cardholders/{id}/addresses/{kind}Requires an API client bearer token.
Replaces the current address of this kind (billing or delivery). The address it replaces is kept in the history, not overwritten: a recently changed address is itself a risk signal. Sending the address already on file changes nothing and records nothing. Requires an Idempotency-Key header. Emits cardholder.updated naming billing_address or delivery_address — never the address itself.
Parameters
Path parameters
| Name | Required | Description |
|---|---|---|
| id | required | |
| kind | required |
Header parameters
| Name | Required | Description |
|---|---|---|
| Idempotency-Key | required | Client-chosen. An identical retry with the same key returns the stored response; reusing the key with a different payload returns 409. |
Request body
The street name, without the building number.
The building or house number as written, such as "221B". Kept apart from the street because address matching (AVS, 3-D Secure risk checks) compares it on its own. Omit it for an address with no number.
Anything else the address needs: flat, floor, building name, care-of.
The postal code as written. Omit it only where the country has none: address matching compares it on its own.
The city, town or locality.
The state, province or county, where the country uses one.
ISO 3166-1 alpha-2, upper case (GB, DE, US).
Example
curl -X PUT https://api.rigid.fi/v1/cardholders/{id}/addresses/{kind} \
-H "Authorization: Bearer $RIGID_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"street": "string",
"city": "string",
"country": "string"
}'Responses
200The address now on file for this kind.
When this address was set. For the current address: on file since.
400Validation error
401Authentication required
403Forbidden — the caller may not act on this programme, or (code `live_mode_card_read_only`) live mode refuses setting a cardholder address, pending scheme certification
404Cardholder not found
409Idempotency-Key reused with a different payload
500Internal server error