CreatePaymentIntentRequest

  • amount
    Type: string Pattern: ^\d+\.\d{2}$
    required

    Payment amount as a decimal string with two decimal places (e.g., "50.00"). Must be >= 1.00.

  • currency
    enum
    const:  
    EUR
    required

    Three-letter ISO 4217 currency code

    values
    • EUR
  • customer
    Type: object · Customer
    required

    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.

  • paymentMethod
    required

    Payment method with provider-specific parameters. The object is discriminated by the id field. Each method has its own required/optional fields and some also add conditional requirements to the customer object (see individual schemas).

    • id
      Discriminator
      enum
      const:  
      mbway-eupago
      required
      values
      • mbway-eupago
    • phone
      Type: string Pattern: ^\+351\d{9}$
      required

      Customer's mobile phone number (Portuguese format)

  • reference
    Type: string
    min length:  
    1
    max length:  
    255
    required

    Your unique order/transaction ID. Used for idempotency.

  • returnLinks
    Type: object · ReturnLinks
    required
    • default
      Type: stringFormat: uri
      required

      Default return URL (used for success if not specified separately)

    • cancel
      Type: stringFormat: uri

      URL to redirect when customer cancels the payment