Create a signed mandate

POST

https://api.lipafy.xyz/v1/intent-mandates

POST

/v1/intent-mandates

$ curl -X POST https://api.lipafy.xyz/v1/intent-mandates \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "natural_language_description": "string",
>   "capability_slug_patterns": [
>     "string"
>   ],
>   "max_amount_per_fulfillment": "string",
>   "total_budget": "string",
>   "expires_at": "2024-01-15T09:30:00Z",
>   "nonce": "string",
>   "signature": "string"
> }'

201Created

1 {
2   "mandate": {
3     "id": "string",
4     "natural_language_description": "string",
5     "capability_slug_patterns": [
6       "string"
7     ],
8     "allowed_merchants": [
9       "string"
10     ],
11     "max_amount_per_fulfillment": "string",
12     "total_budget": "string",
13     "consumed_amount": "string",
14     "currency_code": "string",
15     "max_fulfillments": 1,
16     "fulfillment_count": 1,
17     "expires_at": "2024-01-15T09:30:00Z",
18     "status": "open",
19     "created_at": "2024-01-15T09:30:00Z"
20   }
21 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

natural_language_descriptionstringRequired1-2000 characters

capability_slug_patternslist of stringsRequired

max_amount_per_fulfillmentstringRequired

total_budgetstringRequired

expires_atdatetimeRequired

noncestringRequired

signaturestringRequiredformat: "^0x[a-fA-F0-9]+$"

allowed_merchantslist of strings or nullOptional

currency_codestringOptionalDefaults to KES

max_fulfillmentsintegerOptional1-1000Defaults to 1

conditionsmap from strings to anyOptional

Response

Created

mandateobject