Report an Event for a Payment Evaluation 

Associate a payment’s post-transaction events, such as refunds and disputes, or pre-transaction events, such as user interventions, with the payment evaluation.

Parameters

• eventsarray of objectsRequired

  Event information to associate with the payment evaluation such as refunds, dispute, early fraud warnings, or user interventions.

  Hide child parameters

  • events.occurred_attimestampRequired

    Timestamp when the event occurred.

  • events.typeenumRequired

    Indicates the type of event attached to the payment evaluation.

    Possible enum values

    dispute_opened Event type for when a dispute is opened.

    early_fraud_warning_received Event type for when an early fraud warning is received.

    refunded Event type for when a payment is refunded.

    user_intervention_raised Event type for when a user intervention is raised.

    user_intervention_resolved Event type for when a user intervention is resolved.

  • events.dispute_openedobject

    Details about the dispute opened event.

    Hide child parameters

    • events.dispute_opened.amountintegerRequired

      Amount to dispute for this payment. A positive integer representing how much to charge in the smallest currency unit (for example, 100 cents to charge 1.00 USD or 100 to charge 100 Yen, a zero-decimal currency).

    • events.dispute_opened.currencyenumRequired

      Three-letter ISO currency code, in lowercase. Must be a supported currency.

    • events.dispute_opened.reasonenumRequired

      Reason given by cardholder for dispute.

      Possible enum values

      account_not_available The account isn’t available.

      credit_not_processed The cardholder claims they should have received a refund or credit but haven’t.

      customer_initiated The cardholder disputed the transaction.

      duplicate The cardholder claims they were incorrectly charged multiple times for the same products or services.

      fraudulent The cardholder claims that a payment was unauthorized and that they didn’t initiate it or give permission for it to happen.

      general The reason doesn’t match any of the other dispute reasons.

      noncompliant The transaction is noncompliant.

      product_not_received The cardholder claims they didn’t receive the products or services they purchased.

      product_unacceptable The cardholder claims a product they received is defective, damaged, or not as described. This includes issues with the product itself or how it was represented on the seller’s site.

      subscription_canceled The cardholder claims that a business continued to charge them after their subscription was canceled.

      Show 1 more

  • events.early_fraud_warning_receivedobject

    Details about the early fraud warning received event.

    Hide child parameters

    • events.early_fraud_warning_received.fraud_typeenumRequired

      The type of fraud labeled by the issuer.

      Possible enum values

      made_with_lost_card The payment might be fraudulent because the card was reported lost.

      made_with_stolen_card The payment might be fraudulent because the card was reported stolen.

      other The reason doesn’t match any of the other reasons.

      unauthorized_use_of_card The payment might be fraudulent because the card was used without the cardholder’s permission.

  • events.refundedobject

    Details about the refunded event.

    Hide child parameters

    • events.refunded.amountintegerRequired

      Amount refunded for this payment. A positive integer representing how much to charge in the smallest currency unit (for example, 100 cents to charge 1.00 USD or 100 to charge 100 Yen, a zero-decimal currency).

    • events.refunded.currencyenumRequired

      Three-letter ISO currency code, in lowercase. Must be a supported currency.

    • events.refunded.reasonenumRequired

      Indicates the reason for the refund.

      Possible enum values

      duplicate The merchant has indicated the refund is because of a duplicate payment.

      fraudulent The merchant has indicated the refund is because of fraud.

      other The reason doesn’t match any of the other refund reasons.

      requested_by_customer The merchant has indicated the refund was requested by the customer.

  • events.user_intervention_raisedobject

    Details about the user intervention raised event.

    Hide child parameters

    • events.user_intervention_raised.typeenumRequired

      Type of user intervention raised.

      Possible enum values

      3ds 3DS Authentication

      captcha CAPTCHA Security Test

      custom Custom Intervention

    • events.user_intervention_raised.customobject

      Details for custom interventions.

      Hide child parameters

      • events.user_intervention_raised.custom.typestringRequired

        Custom type of user intervention raised. The string must use a snake case description for the type of intervention performed.

  • events.user_intervention_resolvedobject

    Details about the user intervention resolved event.

    Hide child parameters

    • events.user_intervention_resolved.keystringRequired

      Unique ID of the intervention.

    • events.user_intervention_resolved.outcomeenumRequired

      Result of the intervention.

      Possible enum values

      abandoned The customer abandoned the user intervention.

      failed The customer failed the user intervention.

      passed The customer passed the user intervention.

• payment_evaluationstringRequired

  Unique identifier for the payment evaluation to attach the events to.

• metadataobject

  Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.