Skip to main content
POST
/
mpp
/
settle
Settle an MPP payment
curl --request POST \
  --url https://api.getovra.com/mpp/settle \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "intentId": "int_7Kx9mQ3pR2nL4sT",
  "agentId": "ag_abc123",
  "expectedAmountCents": "1999",
  "expectedCurrency": "eur",
  "merchant": "api.example.com"
}
'
{
  "transactionId": "tx_abc123",
  "intentId": "int_7Kx9mQ3pR2nL4sT",
  "amountEuros": 19.99,
  "status": "settled"
}

Authorizations

​
Authorization
string
header
required

API key (sk_...) or Agent token (at_...)

Body

application/json
​
intentId
string
required

Approved Ovra intent ID (crypto-random, single-use)

Example:

"int_7Kx9mQ3pR2nL4sT"

​
agentId
string
required

Ovra agent ID that authorized the payment

Example:

"ag_abc123"

​
expectedAmountCents
string
required

Expected amount in smallest currency unit (cents for EUR)

Example:

"1999"

​
expectedCurrency
string

ISO currency code (lowercase)

Example:

"eur"

​
merchant
string

Merchant or service identifier

Example:

"api.example.com"

Response

Payment settled successfully

​
transactionId
string
Example:

"tx_abc123"

​
intentId
string
Example:

"int_7Kx9mQ3pR2nL4sT"

​
amountEuros
number
Example:

19.99

​
status
enum<string>
Available options:
settled