Synctera.Cards (Synctera v1.0.0)

Copy Markdown View Source

Synctera 'Cards' endpoints.

Code generated by scripts/generate.py from the Synctera OpenAPI spec. Do not edit by hand — re-run mix generate (or python3 scripts/generate.py) to regenerate.

Summary

Functions

Activate a card — Activate a card

Like activate_card/2 but returns the value directly and raises on error.

Create Card Image — Create a card image entity. Note that this does not include the image data itself. You can upload the image data via a subsequent uploadCardImageData request using the ID created here.

Like create_card_image/2 but returns the value directly and raises on error.

Create Gateway — Create a new Authorization Gateway Configuration

Like create_gateway/2 but returns the value directly and raises on error.

Get Card — Get the details about a card that has been issued

Like get_card/3 but returns the value directly and raises on error.

Get Card Barcode — This endpoint is for testing environment only to provide access to barcode of a test card

Like get_card_barcode/3 but returns the value directly and raises on error.

Get Card Image Data — Get card image data

Like get_card_image_data/3 but returns the value directly and raises on error.

Get Card Image Details — Get card image details

Like get_card_image_details/3 but returns the value directly and raises on error.

Get card widget URL — This endpoint returns a URL address of the specified widget for a given card

Like get_card_widget_url/2 but returns the value directly and raises on error.

Get a client token — Create a client access token for interacting with a card. This token will be used on the client to identify the card for flows like viewing Full PAN or setting the PIN in a PCI compliant manner.

Like get_client_access_token/3 but returns the value directly and raises on error.

Get single-use token — This endpoint returns a single-use access token. This type of token authorizes a single request to access API endpoints and data associated with a particular user

Like get_client_single_use_token/2 but returns the value directly and raises on error.

Get Gateway — Get the details of an Authorization Gateway that has been configured

Like get_gateway/3 but returns the value directly and raises on error.

Issue a Card — Issue or reissue a new card for a customer

Like issue_card/2 but returns the value directly and raises on error.

List Card Image Details — List all card image details

Like list_card_image_details/2 but returns the value directly and raises on error.

Like list_card_products/2 but returns the value directly and raises on error.

List Cards — List of cards matching query parameters

Like list_cards/2 but returns the value directly and raises on error.

List Card Changes — List card change history

Like list_changes/3 but returns the value directly and raises on error.

List Gateways — List of gateways matching query parameters

Like list_gateways/2 but returns the value directly and raises on error.

Update Card — Integrators can update the card resource to change status, update shipping (if the card hasn't been shipped) or edit metadata.

Like update_card/3 but returns the value directly and raises on error.

Update Card Image Details — Update card image details. The only detail that can be updated is the card status as APPROVED or REJECTED.

Like update_card_image_details/3 but returns the value directly and raises on error.

Update Gateway — Update Authorization Gateway configuration

Like update_gateway/3 but returns the value directly and raises on error.

Upload Card Image — Upload card image data

Like upload_card_image_data/3 but returns the value directly and raises on error.

Functions

activate_card(client, opts \\ [])

@spec activate_card(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Activate a card — Activate a card

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

activate_card!(client, opts)

@spec activate_card!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like activate_card/2 but returns the value directly and raises on error.

create_card_image(client, opts \\ [])

@spec create_card_image(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Create Card Image — Create a card image entity. Note that this does not include the image data itself. You can upload the image data via a subsequent uploadCardImageData request using the ID created here.

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

create_card_image!(client, opts)

@spec create_card_image!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like create_card_image/2 but returns the value directly and raises on error.

create_gateway(client, opts \\ [])

@spec create_gateway(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Create Gateway — Create a new Authorization Gateway Configuration

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

create_gateway!(client, opts)

@spec create_gateway!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like create_gateway/2 but returns the value directly and raises on error.

get_card(client, card_id, opts \\ [])

@spec get_card(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get Card — Get the details about a card that has been issued

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_card!(client, card_id, opts)

@spec get_card!(Synctera.Client.t(), String.t(), keyword()) :: Synctera.JSON.json()

Like get_card/3 but returns the value directly and raises on error.

get_card_barcode(client, card_id, opts \\ [])

@spec get_card_barcode(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get Card Barcode — This endpoint is for testing environment only to provide access to barcode of a test card

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_card_barcode!(client, card_id, opts)

@spec get_card_barcode!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like get_card_barcode/3 but returns the value directly and raises on error.

get_card_image_data(client, card_image_id, opts \\ [])

@spec get_card_image_data(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get Card Image Data — Get card image data

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_card_image_data!(client, card_image_id, opts)

@spec get_card_image_data!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like get_card_image_data/3 but returns the value directly and raises on error.

get_card_image_details(client, card_image_id, opts \\ [])

@spec get_card_image_details(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get Card Image Details — Get card image details

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_card_image_details!(client, card_image_id, opts)

@spec get_card_image_details!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like get_card_image_details/3 but returns the value directly and raises on error.

get_card_widget_url(client, opts \\ [])

@spec get_card_widget_url(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get card widget URL — This endpoint returns a URL address of the specified widget for a given card

Options

Query options: :widget_type, :customer_id, :account_id, :card_id

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_card_widget_url!(client, opts)

@spec get_card_widget_url!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like get_card_widget_url/2 but returns the value directly and raises on error.

get_client_access_token(client, card_id, opts \\ [])

@spec get_client_access_token(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get a client token — Create a client access token for interacting with a card. This token will be used on the client to identify the card for flows like viewing Full PAN or setting the PIN in a PCI compliant manner.

Options

  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_client_access_token!(client, card_id, opts)

@spec get_client_access_token!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like get_client_access_token/3 but returns the value directly and raises on error.

get_client_single_use_token(client, opts \\ [])

@spec get_client_single_use_token(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get single-use token — This endpoint returns a single-use access token. This type of token authorizes a single request to access API endpoints and data associated with a particular user

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_client_single_use_token!(client, opts)

@spec get_client_single_use_token!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like get_client_single_use_token/2 but returns the value directly and raises on error.

get_gateway(client, gateway_id, opts \\ [])

@spec get_gateway(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Get Gateway — Get the details of an Authorization Gateway that has been configured

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

get_gateway!(client, gateway_id, opts)

@spec get_gateway!(Synctera.Client.t(), String.t(), keyword()) :: Synctera.JSON.json()

Like get_gateway/3 but returns the value directly and raises on error.

issue_card(client, opts \\ [])

@spec issue_card(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Issue a Card — Issue or reissue a new card for a customer

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

issue_card!(client, opts)

@spec issue_card!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like issue_card/2 but returns the value directly and raises on error.

list_card_image_details(client, opts \\ [])

@spec list_card_image_details(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

List Card Image Details — List all card image details

Options

Query options: :customer_id

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

list_card_image_details!(client, opts)

@spec list_card_image_details!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like list_card_image_details/2 but returns the value directly and raises on error.

list_card_products(client, opts \\ [])

@spec list_card_products(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

List Card Products

Options

Query options: :limit, :page_token

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

list_card_products!(client, opts)

@spec list_card_products!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like list_card_products/2 but returns the value directly and raises on error.

list_cards(client, opts \\ [])

@spec list_cards(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

List Cards — List of cards matching query parameters

Options

Query options: :customer_id, :account_id, :emboss_name, :last_four, :expiration_date, :card_type, :card_brand, :form, :card_product_id, :card_status, :postal_code, :limit, :page_token, :sort_by

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

list_cards!(client, opts)

@spec list_cards!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like list_cards/2 but returns the value directly and raises on error.

list_changes(client, card_id, opts \\ [])

@spec list_changes(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

List Card Changes — List card change history

Options

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

list_changes!(client, card_id, opts)

@spec list_changes!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like list_changes/3 but returns the value directly and raises on error.

list_gateways(client, opts \\ [])

@spec list_gateways(
  Synctera.Client.t(),
  keyword()
) :: {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

List Gateways — List of gateways matching query parameters

Options

Query options: :limit, :page_token

  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

list_gateways!(client, opts)

@spec list_gateways!(
  Synctera.Client.t(),
  keyword()
) :: Synctera.JSON.json()

Like list_gateways/2 but returns the value directly and raises on error.

update_card(client, card_id, opts \\ [])

@spec update_card(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Update Card — Integrators can update the card resource to change status, update shipping (if the card hasn't been shipped) or edit metadata.

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

update_card!(client, card_id, opts)

@spec update_card!(Synctera.Client.t(), String.t(), keyword()) :: Synctera.JSON.json()

Like update_card/3 but returns the value directly and raises on error.

update_card_image_details(client, card_image_id, opts \\ [])

@spec update_card_image_details(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Update Card Image Details — Update card image details. The only detail that can be updated is the card status as APPROVED or REJECTED.

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

update_card_image_details!(client, card_image_id, opts)

@spec update_card_image_details!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like update_card_image_details/3 but returns the value directly and raises on error.

update_gateway(client, gateway_id, opts \\ [])

@spec update_gateway(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Update Gateway — Update Authorization Gateway configuration

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

update_gateway!(client, gateway_id, opts)

@spec update_gateway!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like update_gateway/3 but returns the value directly and raises on error.

upload_card_image_data(client, card_image_id, opts \\ [])

@spec upload_card_image_data(Synctera.Client.t(), String.t(), keyword()) ::
  {:ok, Synctera.JSON.json()} | {:error, Synctera.Error.t()}

Upload Card Image — Upload card image data

Options

  • :body — request body (map), required.
  • :idempotency_key — see Synctera.Idempotency.
  • :device_info — a %Synctera.DeviceInfo{} overriding the client default.

upload_card_image_data!(client, card_image_id, opts)

@spec upload_card_image_data!(Synctera.Client.t(), String.t(), keyword()) ::
  Synctera.JSON.json()

Like upload_card_image_data/3 but returns the value directly and raises on error.