---
title: "Prevent financial losses by deploying AI-Powered modules"
method: POST
path: "/score/payments"
tags: ["Scoring"]
---

# Prevent financial losses by deploying AI-Powered modules

`POST /score/payments`

## Request

- Base URL: `https://v2.greipapi.com`
- URL: `https://v2.greipapi.com/score/payments`
- Auth: HTTP bearer

Prevent financial losses and protect your business by deploying AI-powered modules that analyze transaction patterns in real-time.

This method helps identify and block suspicious activities, mitigating the risk of fraudulent payments and ensuring a secure experience for both you and your customers.

## Request body

- ScorePaymentsRequest
  - `format` string
  - `mode` string
  - `source` string
  - `data` PaymentScoreRequestData, required: Transaction and customer fields for payment fraud scoring. Additional keys are accepted.
    - `action` string: purchase, deposit, or withdrawal
    - `customer_ip` string
    - `customer_email` string
    - `transaction_id` string
    - `transaction_amount` number
    - `transaction_currency` string

## Response `200`

OK

- GreipJsonSuccessEnvelope
  - `success` boolean, required
  - `data` object, required: Endpoint-specific payload.
  - `execution_ms` integer, required

## Changes

- **2026-11-03** `5ef5b288383a`: 2 breaking, 4 warning, 2 info
  - added `#/components/schemas/GreipServiceRequestFields, subschema #2` to the request body `allOf` list
  - the request's body type changed from `object` to no type
  - removed the request property `data`
  - removed the request property `format`
  - …4 more
- **2026-10-19** `9346ce4dfd7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/greip/apis/greip-api/changes/score/payments/post.md)

---

[API](https://skmtc.dev/greip/apis/greip-api.md) - [All operations](https://skmtc.dev/greip/apis/greip-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greip/apis/greip-api/revisions/5ef5b288383a?raw)
