Sign in

v1

latestOpenAPI 3.0.02026-07-26167441.9 MB

Enroll Payment Method

post/customers/{customer_id}/payment-methods

Path parameters

customer_idstring required

The unique identifier of the customer, created using the Create Customer endpoint (MAX 64; MIN 36).

Request body

account_idstring required

The unique identifier of the account. You find this information on Yuno's Dashboard (MAX 64; MIN 36).

country'AR' | 'BO' | 'BR' | 'CL' | 'CO' | 'CR' | 'EC' | 'SV' | 'GT' | 'HN' | 'MX' | 'NI' | 'PA' | 'PY' | 'PE' | 'US' | 'UY' | '' required

The transaction's country code (MAX 2; MIN 2; ISO 3166-1).

type'CARD' | 'ACH_ENROLLMENT' | 'NU_PAY_ENROLLMENT' required

The payment method type (MAX 255; MIN 3; Payment type).

workflow'DIRECT'

The payment workflow indicates whether the integration will use Yuno's SDK or will be a back to back connection. Since you are in the Direct workflow, the value must be DIRECT.

callback_urlstring

URL to return the customer after an enrollment in a provider´s environment. Only necessary for alternative payment methods integrations (MAX 255; MIN 3).

tokenstring uuid

Pre-generated token used to reference the payment method being enrolled.

parent_typestring

Type of the parent payment method, used when enrolling a tokenized/derived method (e.g. CARD).

account_updaterboolean

Per-card control for Card Account Updater. When set to false, this card is excluded from Card Account Updater and will not receive automatic card-detail updates. When omitted, the card follows your account's Account Updater configuration. Applies at enrollment.

Response

201

OR

Example response

{
  "idempotency_key": "2ca58c6d-8794-4c8f-a2f6-bba4b7498b74",
  "name": "VISA ****1111",
  "description": "VISA ****1111",
  "type": "CARD",
  "category": "CARD",
  "country": "US",
  "status": "ENROLLED",
  "vaulted_token": "cbdcc878-ceb4-4dd8-b0f0-49d444855de0",
  "callback_url": "www.example.com",
  "parent_type": "CARD",
  "created_at": "2024-06-06T13:32:49.715656Z",
  "updated_at": "2024-06-06T13:32:49.715656Z",
  "card_data": {
    "iin": "41111111",
    "lfd": "1111",
    "holder_name": "JOHN DOE",
    "expiration_month": 3,
    "expiration_year": 26,
    "number_length": 16,
    "security_code_length": 3,
    "brand": "VISA",
    "issuer": "JPMORGAN CHASE BANK N A",
    "country_code": "US",
    "category": "CREDIT",
    "type": "CREDIT",
    "fingerprint": "55a7fe38-cdc3-45dc-8c5f-820751799c76"
  }
}