Skip to main content
POST
/
v1
/
customers
/
{customer_id}
/
payment-methods
Enroll Payment Method — Direct API
curl --request POST \
  --url https://api-sandbox.y.uno/v1/customers/{customer_id}/payment-methods \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": "YOUR_ACCOUNT_ID",
  "country": "US",
  "type": "CARD",
  "workflow": "DIRECT",
  "callback_url": "https://example.com/enrollment/callback",
  "verify": {
    "vault_on_success": true,
    "currency": "USD"
  }
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "VISA ****1111",
  "type": "<string>",
  "category": "<string>",
  "vaulted_token": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "ENROLLED",
  "card_data": {
    "iin": "<string>",
    "lfd": "<string>",
    "brand": "<string>",
    "issuer": "<string>",
    "fingerprint": "<string>"
  }
}

Path Parameters

customer_id
string<uuid>
required

Body

application/json
account_id
string<uuid>
required
country
enum<string>
required

ISO 3166-1 alpha-2 country code

Available options:
AR,
BO,
BR,
CL,
CO,
CR,
EC,
SV,
GT,
HN,
MX,
NI,
PA,
PY,
PE,
US,
UY
type
enum<string>
required
Available options:
CARD,
NU_PAY_ENROLLMENT
workflow
enum<string>
required
Available options:
DIRECT
callback_url
string<uri>
verify
object

Response

200 - application/json

Payment method enrolled

id
string<uuid>
name
string
Example:

"VISA ****1111"

type
string
category
string
vaulted_token
string<uuid>
status
enum<string>
Available options:
ENROLLED,
READY_TO_ENROLL
card_data
object