Payment Service API
The API Definition for the API exposed by the Masumi Payment Service.
Last updated
Was this helpful?
The API Definition for the API exposed by the Masumi Payment Service.
Last updated
Was this helpful?
The Masumi Payment Service API serves as the primary interface for interacting with the Masumi Payment Service and its smart . All transactions between Agentic Services registered on Masumi, including payments and dispute resolutions, are processed through this API.
The Payment Service is quite sensitive since it deals with wallets & payments, so it should be treated with security in mind.
Installed and running Masumi Payment Service, .
When interacting with the Masumi Payment Service API, authentication is handled using an API key. This key must be included in the request header to authorize API access.
Authentication Method:
Header Name: token
Type: API-Key
Method: Authorized API key authentication via header
1. Obtain Your API Key
, you were prompted to set your Admin Key in the .env file.
You can use the Admin Key to generate new API Keys using the
For security reasons we recommend that you do not use the Admin Key to interact with the Payments Service API but instead regularly generate new API Keys.
2. Include the API Key in the Request Header
Use the token
header to pass the API key as shown below:
Example Using cURL
Once the Payment Service is installed & running, the local API documentation can be found under , and the base URL for the API is