Update Card Styling

patch

{base_url}/api/distributor/v1/distributor_cards/{distributor_card_uuid}/styling

Updates text-field styling attributes (hex colors and mCash title) for a distributor card.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

distributor_card_uuid

string

required

UUID of the distributor card

Body Params

Card-level styling and branding metadata returned by the Distributors API. Contains only fields the distributor can configure - mCash currency branding, gradient stops for generated card artwork, the card text color, and the splash-screen image URL. The card-face image is not exposed here (it is returned by the distributor card show endpoint as distributor_card_image_url). Landing-page theme color is owned by a separate landing_page_styling resource.

mcash_title

string | null

Card-level branded display name for the mCash currency (e.g. "Buoy Bucks"). Falls back to the marketer-level or global default when unset on the card.

gradient_start

string | null

^#[0-9a-fA-F]{6}$

Gradient start color (hex). Used for the card face.

gradient_middle

string | null

^#[0-9a-fA-F]{6}$

Gradient middle color (hex).

gradient_end

string | null

^#[0-9a-fA-F]{6}$

Gradient end color (hex).

card_text_color

string

^#[0-9a-fA-F]{6}$

Color (hex) used by the mobile apps for the card number and expiration date painted over the card artwork. Defaults to #FFFFFF. Only the hex format is validated - contrast against the gradient is not enforced by the API.

Responses

400

unknown field

401

unauthorized request

403

forbidden request

404

cross-distributor write is blocked

200mcash_title persisted via reward currency