# Payment card created

Endpoint: POST payment-card-created
Version: latest
Security: SecretApiKey, JWT

## Request fields

- `paymentCardId` (string)
  ID of the payment instrument.
- `eventType` (string)
  Type of event that triggered the webhook.
  Enum: "payment-card-created", "payment-card-expiration-reminder", "payment-card-expired"
- `_embedded` (object)
  Embedded objects related to the payment card event.
- `_embedded.paymentCard` (object)
  Payment card information.
- `_embedded.paymentCard.customerId` (string)
  ID of the customer resource.
  Example: cus_0YV7DDSDD1C8DA64KHH2W33CPF
- `_embedded.paymentCard.status` (string)
  Status of the payment instrument. An `active` status means that a payment instrument has been used at least once for an approved transaction. To remove an instrument from use, set this value to `deactivated`. For more information, see [`POST /payment-instruments/{id}/deactivation`](https://www.rebilly.com/catalog/all/payment-instruments/postpaymentinstrumentdeactivation).
  Enum: "active", "inactive", "expired", "deactivated", "verification-needed"
- `_embedded.paymentCard.pan` (string)
  Primary Account Number (PAN) of the payment card.
- `_embedded.paymentCard.expYear` (integer)
  Expiration year of the payment card.
- `_embedded.paymentCard.expMonth` (integer)
  Expiration month of the payment card.
- `_embedded.paymentCard.cvv` (string)
  Card Verification Value (CVV) of the payment card.
- `_embedded.paymentCard.brand` (string)
  Brand of payment card.
  Enum: "Visa", "MasterCard", "American Express", "Discover", "Maestro", "Solo", "Electron", "JCB", "Voyager", "Diners Club", "Switch", "Laser", "China UnionPay", "AstroPay Card"
- `_embedded.paymentCard.billingAddress` (object)
  Contact's information.
- `_embedded.paymentCard.billingAddress.firstName` (string | null)
  Contact's first name.
  Example: Benjamin
- `_embedded.paymentCard.billingAddress.lastName` (string | null)
  Contact's last name.
  Example: Franklin
- `_embedded.paymentCard.billingAddress.organization` (string | null)
  Contact's organization.
  Example: Rebilly
- `_embedded.paymentCard.billingAddress.address` (string | null)
  First line of the contact's street address.
  Example: 36 Craven St
- `_embedded.paymentCard.billingAddress.address2` (string | null)
  Second line of the contact's street address.
- `_embedded.paymentCard.billingAddress.city` (string | null)
  Contact's city of residence.
  Example: Austin
- `_embedded.paymentCard.billingAddress.region` (string | null)
  Contact's region of residence.
  Example: Texas
- `_embedded.paymentCard.billingAddress.country` (string | null)
  Contact's country of residence in ISO 3166 alpha-2 country code. For examples, see [ISO.org](https://www.iso.org/obp/ui/#search/code/).
  Example: GB
- `_embedded.paymentCard.billingAddress.postalCode` (string | null)
  Contact's postal code.
  Example: WC2N 5NF
- `_embedded.paymentCard.billingAddress.phoneNumbers` (array)
  List of phone numbers associated with the contact.
- `_embedded.paymentCard.billingAddress.phoneNumbers.label` (string, required)
  Phone number label or name.
  Example: main
- `_embedded.paymentCard.billingAddress.phoneNumbers.value` (string, required)
  Phone number value.
  Example: 1-512-777-0269
- `_embedded.paymentCard.billingAddress.phoneNumbers.primary` (boolean)
  Specifies if the phone number is the contact's primary phone number.
  Example: true
- `_embedded.paymentCard.billingAddress.emails` (array)
  List of email addresses associated with the contact.
- `_embedded.paymentCard.billingAddress.emails.label` (string, required)
  Email label or name.
  Example: main
- `_embedded.paymentCard.billingAddress.emails.value` (string, required)
  Email address value.
  Example: rebilly@example.com
- `_embedded.paymentCard.billingAddress.emails.primary` (boolean)
  Specifies if the email address is the contact's primary email address.
  Example: true
- `_embedded.paymentCard.billingAddress.dob` (string | null)
  Contact's date of birth in ISO-8601 `YYYY-MM-DD` format.
  Example: 1980-04-01
- `_embedded.paymentCard.billingAddress.jobTitle` (string | null)
  Contact's job title.
  Example: CEO
- `_embedded.paymentCard.useAsBackup` (boolean)
  Specifies if this payment instrument can be used as a backup for invoice payment retries.
- `_embedded.paymentCard.customFields` (object)
  Use custom fields to extend a resource scheme to include custom data that is not provided as a common field. For more information, see [Custom fields](https://www.rebilly.com/catalog/all/custom-fields).
  Example: {"foo":"bar"}
- `_embedded.paymentCard.riskMetadata` (any)
- `_links` (array)
  Links to related resources.
- `_links.href` (string)
  URL of the link.
- `_links.rel` (string)
  Relationship type of the link.
  Enum: "paymentCard"