Customer

Customer associated with the payment. The only unconditional requirement is id. Some payment methods add their own conditional requirements on this object - see the individual method schemas for details (e.g. Rillpay requires name, date of birth and nationality).

  • id
    Type: string
    min length:  
    3
    max length:  
    255
    required

    Your internal customer identifier

  • dateOfBirth
    Type: stringFormat: date nullable

    Customer date of birth in YYYY-MM-DD. Required for card-rillpay and openbanking-rillpay.

  • email
    Type: stringFormat: email nullable

    Customer email address. Required for multibanco-eupago, neteller-paysafe, card-rillpay, and openbanking-rillpay.

  • firstName
    Type: string nullable

    Customer first name. Required for card-rillpay and openbanking-rillpay.

  • ip
    Type: stringFormat: ipv4 nullable

    Customer IP address (used for fraud detection)

  • lastName
    Type: string nullable

    Customer last name. Required for card-rillpay and openbanking-rillpay.

  • nationality
    Type: string Pattern: ^[A-Z]{2}$ nullable

    ISO 3166-1 alpha-2 country code for the customer nationality. Required for openbanking-rillpay.

  • phone
    Type: string nullable

    Customer phone number in E.164 format. Required for card-rillpay.