PaymentIntent

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

    Payment amount as a decimal string with two decimal places

  • createdAt
    Type: stringFormat: date-time
    required

    Timestamp when the payment intent was created

  • currency
    Type: string
    required

    Three-letter ISO 4217 currency code

  • id
    Type: stringFormat: uuid
    required

    Unique identifier for the payment intent

  • merchantCustomerId
    Type: string
    required

    Your internal customer identifier provided when creating the intent

  • merchantId
    Type: stringFormat: uuid
    required

    Your merchant account identifier

  • merchantReference
    Type: string
    required

    Your unique order or transaction reference provided when creating the intent

  • paymentMethod
    Type: string
    required

    Payment method identifier in "method-provider" format

  • status
    Type: stringenum
    required

    Current lifecycle status of the payment intent:

    • initiated - intent created, provider setup not started yet
    • requires_action - customer needs to complete an action (redirect or pay via requisites)
    • processing - payment is being processed by the provider
    • succeeded - payment is confirmed complete
    • failed - intent failed (e.g. provider error, customer rejection)
    • canceled - intent was canceled or expired without payment
    values
    • initiated
    • requires_action
    • processing
    • succeeded
    • failed
    • canceled
  • action
    nullable

    Redirect the customer to url to complete payment with the provider. Used by neteller-paysafe, paysafecard-trustpayments, card-rillpay, and openbanking-rillpay.

    • type
      Discriminator
      enum
      const:  
      redirect
      required
      values
      • redirect
    • expiresAt
      Type: stringFormat: date-time
      required

      Timestamp after which the redirect URL is no longer valid

    • method
      Type: stringenum
      required

      HTTP method to use when redirecting

      values
      • GET
      • POST
    • url
      Type: stringFormat: uri
      required

      Absolute URL to redirect the customer to

  • paymentId
    Type: stringFormat: uuid nullable

    Identifier of the associated payment. Null until a payment is created for this intent.

  • providerReference
    Type: string nullable

    Reference assigned by the payment provider. Null until the provider returns a reference.