Pomelo

Pomelo (pomelo.la) is a Latin American card-issuing and embedded-finance platform. Its REST API lets fintechs and enterprises onboard users (KYC/KYB), issue physical and virtual cards, manage card accounts and balances, process and query transactions, move money with transfers and settlements, and authorize transactions in real time over a synchronous authorization webhook.

7 APIs 0 Features

FintechCard IssuingEmbedded FinancePaymentsLatin America

APIs

Pomelo Users & KYC API

Register and manage end users (cardholders) and the identity verification lifecycle - create, retrieve, search, and modify users, plus KYC and KYB sessions for individuals and c...

Pomelo Cards API

Create nominated and innominated physical or virtual cards, retrieve and update card status, affinity group and PIN, activate physical cards, manage batches of innominated cards...

Pomelo Card Accounts API

Manage prepaid/banking card accounts and their balances - query account balances, activities, and movements that back the cards a program issues.

Pomelo Transactions API

Search and retrieve processed card transactions and summaries, including purchases, refunds, reversals, and adjustments, with merchant, amount, status, and entry-mode detail.

Pomelo Authorizations API

Real-time authorizer - Pomelo POSTs each incoming card authorization to the client's signed endpoint, which approves or rejects the transaction within the network time window us...

Pomelo Transfers API

Move funds across card accounts and settle program balances - create and query transfers and settlements that fund and reconcile the issuing program.

Pomelo Webhooks API

Configure HTTPS endpoints that receive signed event notifications for cards, users, transactions, and adjustments, validated with the x-endpoint, x-signature, and timestamp head...

Collections

Pomelo API

OPEN

Pricing Plans

Pomelo Plans Pricing

2 plans

PLANS

Rate Limits

Pomelo Rate Limits

5 limits

RATE LIMITS

FinOps

Pomelo Finops

FINOPS

Resources

👥

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Pomelo API
  version: '1.0'
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Obtain an OAuth 2.0 access token
      type: http
    http:
      method: POST
      url: https://auth.pomelo.la/oauth/token
      body:
        type: json
        data: '{"client_id":"<string>","client_secret":"<string>","audience":"https://api.pomelo.la","grant_type":"client_credentials"}'
    docs: Exchange client credentials for a Bearer JWT via the client_credentials grant.
- info:
    name: Users
    type: folder
  items:
  - info:
      name: Create a user
      type: http
    http:
      method: POST
      url: https://api.pomelo.la/users/v1
      body:
        type: json
        data: '{}'
    docs: Register a new cardholder. Email uniquely identifies the user.
  - info:
      name: Search users
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/users/v1
    docs: Query the user database by identification, email, or status.
  - info:
      name: Get a user
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/users/v1/{id}
    docs: Retrieve a user by id.
  - info:
      name: Modify a user
      type: http
    http:
      method: PATCH
      url: https://api.pomelo.la/users/v1/{id}
      body:
        type: json
        data: '{}'
    docs: Update existing personal information for a user.
- info:
    name: Cards
    type: folder
  items:
  - info:
      name: Create a card
      type: http
    http:
      method: POST
      url: https://api.pomelo.la/cards/v1
      body:
        type: json
        data: '{}'
    docs: Create a nominated physical or virtual card for a user.
  - info:
      name: Search cards
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/cards/v1
    docs: Search cards by user or status.
  - info:
      name: Get a card
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/cards/v1/{id}
    docs: Retrieve a card by id.
  - info:
      name: Update a card
      type: http
    http:
      method: PATCH
      url: https://api.pomelo.la/cards/v1/{id}
      body:
        type: json
        data: '{}'
    docs: Update the status, affinity group, or PIN of a card.
  - info:
      name: Activate a physical card
      type: http
    http:
      method: POST
      url: https://api.pomelo.la/cards/v1/activation
      body:
        type: json
        data: '{}'
    docs: Activate a physical card and optionally set its PIN.
  - info:
      name: Create a batch of innominated cards
      type: http
    http:
      method: POST
      url: https://api.pomelo.la/cards/v1/batches
      body:
        type: json
        data: '{}'
    docs: Create a batch of up to 1,000 innominated cards.
  - info:
      name: Update a card shipment address
      type: http
    http:
      method: PATCH
      url: https://api.pomelo.la/cards/v1/{id}/shipment
      body:
        type: json
        data: '{}'
    docs: Update the shipping address of a physical nominated card in CREATED status.
- info:
    name: Card Accounts
    type: folder
  items:
  - info:
      name: Search card accounts
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/accounts/v1
    docs: Search card accounts by user.
  - info:
      name: Get a card account
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/accounts/v1/{id}
    docs: Retrieve a card account and its balance.
  - info:
      name: List account movements
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/accounts/v1/{id}/movements
    docs: List balance movements and activities for a card account.
- info:
    name: Transactions
    type: folder
  items:
  - info:
      name: Search transactions
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/transactions/v1
    docs: Search processed card transactions by user, card, date range, or status.
  - info:
      name: Get a transaction
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/transactions/v1/{id}
    docs: Retrieve a transaction by id.
- info:
    name: Transfers
    type: folder
  items:
  - info:
      name: Create a transfer
      type: http
    http:
      method: POST
      url: https://api.pomelo.la/transfers/v1
      body:
        type: json
        data: '{}'
    docs: Move funds between card accounts to fund or reconcile the program.
  - info:
      name: Search transfers
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/transfers/v1
    docs: Search transfers.
  - info:
      name: Get a transfer
      type: http
    http:
      method: GET
      url: https://api.pomelo.la/transfers/v1/{id}
    docs: Retrieve a transfer by id.