Add Fund

The Add Fund API enables suppliers to recharge the account of a specific business unit within their organization. This endpoint allows users to add credits, supporting efficient financial management and budgeting for campaigns.

warning

It is important to handle account data securely and ensure that access is restricted to authorized users only.

API Endpoint

Method: POST

URL: https://<PA_RM_END_POINT>/retail-media/supplier/{supplierId}/add-balance

info

Please refer to the Supplier API documentation for detailed instructions on how to retrieve the supplierId.

Request Header

Name	Value
Content-Type	application/json
Authorization	Bearer ACCESS_TOKEN

info

Please refer to the Authentication API documentation for bearer token.

Request Parameters

Parameter	Type	Description
supplierId	string	Get the supplier ID from the supplier API

Request Parameters (Body)

Parameter	Type	Description
amount	decimal	The amount of funds to be added to the business unit's fund balance.

Example Request Payload

{
    "amount": 500.00
}

Response Payload

Success Response

• Status Code: 200 OK
• Payload: Returns account information of the supplier with balance in JSON format

{
    "account": {
        "id": "xxxxxxxxxxxxxxxxxxxxxxxxx",
        "credits": 8854.26,
        "spent": 7898.93,
        "balance": 1200, 
    }
}

Response Parameters

Parameter	Type	Description
id	GUID	System generted account ID for the supplier in PA system.
credits	decimal	Total amount that has been added.
spent	decimal	Total amount that has been spent.
balance	decimal	Available balance for the account

Error Response

If an error occurs, the API will return an appropriate status code along with an error message.

• Sample Error Response (400 Bad Request):

{
  "errors": [
    "Error message 1",
    "Error message 2"
  ],
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "xxxxxxxxxxxxxxxxxxx"
}

Example Usage (JavaScript)

var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "BEARER YOUR_ACCESS_TOKEN");

const body = JSON.stringify({"amount": 500.00})

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: body
};

fetch("https://<PA_RM_END_POINT>/retail-media/supplier/{supplierId}/add-balance", requestOptions)
  .then(response => response.json())
  .then(result=> { 
    console.log(result);
  })
  .catch(error => console.log('error', error));