Skip to main content

Create a card

POST 
/payment-methods/cards

When you create a new credit card, you must specify a customer or recipient on which to create it.

Request​

Body

required

    id uuid

    Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

    UUID v4

    customer_id uuidrequired

    Possible values: <= 36 characters, Value must match regular expression ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

    UUID v4

    number stringrequired

    Card number with no spaces or any other character different to an integer number

    exp_month stringrequired

    Possible values: >= 2 characters and <= 2 characters

    2 digit expiration month

    exp_year stringrequired

    Possible values: >= 4 characters and <= 4 characters

    4 digit expiration year

    cvv stringrequired

    Possible values: >= 3 characters and <= 4 characters

    billing_details

    object

    required

    name stringnullable

    Possible values: <= 255 characters

    Name of the billing contact person

    email emailnullable

    Possible values: <= 255 characters

    Email Address

    phone_number PhoneNumber (string)nullable

    Possible values: non-empty and <= 20 characters

    Phone Number

    address

    object

    Address of the billing contact

    country CountryISO (string)nullable

    Possible values: >= 2 characters and <= 2 characters

    Two-letter code ISO 3166-1 country code

    line1 stringnullable

    Possible values: <= 255 characters

    line2 stringnullable

    Possible values: <= 255 characters

    zip stringnullable

    Possible values: <= 255 characters

    city stringnullable

    Possible values: <= 255 characters

    state stringnullable

    Possible values: <= 255 characters

Responses​

Card created successfully

Schema

    status string

    Possible values: [success]

    code integer

    Possible values: [200]

    message string

    Possible values: [Successful request]

Loading...