Skip to main content
GET
/
payinRequests
Retrieve payin requests
curl --request GET \
  --url https://prod.api.palomma.com/v0/payinRequests \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "01HPR83V7JBNJTKT303NTY3YGA",
      "reference": "<string>",
      "customerId": "01HPR57X6QR5ZRKEEKBSDBW4RA",
      "customerDetails": {
        "reference": "<string>",
        "name": "Pepito Perez",
        "documentType": "cc",
        "documentNumber": "1037551022",
        "email": "[email protected]",
        "phoneNumber": "3013111111"
      },
      "payinSourceId": "01HPR7A40E44S0WDR189YXA8GH",
      "payinSourceDetails": {
        "reference": "<string>",
        "description": "<string>",
        "partialPayinsEnabled": true,
        "type": "bankAccount"
      },
      "status": "approved",
      "statusMessage": "AUTHENTICATION_FAILED",
      "amount": 100000,
      "amountCollected": 100000,
      "fee": 500,
      "targetMerchantAccountId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "fa4c20cf2b51f6a45377c98271e3754da1e29b6827928a8e0b40da5a7d53c971aa22c50b2c8ce83484a0dd36ee0e2570a0520a4f1f4817962d95ba65059b9a28da1a5d4ac7bfe7628fb917efd20608656da58b412ea758ec341cd6dfb226f8be263cefa811848b859a5a71f90f47533e01e969d49c0ac9e4e944b3d0fbd4e207",
  "count": 123
}
This endpoint is paginated to improve its performance. The example below shows how to fetch multiple pages.
import axios from "axios";

const getPage = async (input: { limit?: number; cursor?: string }) => {
  const response = await axios.get(
    "https://prod.api.palomma.com/v0/payinRequests",
    {
      headers: {
        Authorization: "Bearer <token>",
      },
      params: {
        ...input,
      },
    }
  );
  if (!response.data) throw new Error();
  const { items, cursor, count } = response.data;
  return { items, cursor, count };
};

const getAll = async (input: { limit?: number }) => {
  let items: any[] = [];
  const firstPage = await getPage({ limit: input.limit });
  if (firstPage) {
    items = items.concat(firstPage.items);
    let currentCursor = firstPage.cursor;
    while (currentCursor !== null) {
      const nextPage = await getPage({
        limit: input.limit,
        cursor: currentCursor,
      });
      items = items.concat(nextPage.items);
      currentCursor = nextPage.cursor;
    }
  }
  return items;
};

Authorizations

​
Authorization
string
header
required

Query Parameters

​
reference
string
​
customerId
string
​
payinSourceId
string
​
payinSettlementId
string
​
limit
integer
​
cursor
string

Response

​
items
object[]
​
cursor
string | null
Example:
​
count
integer