Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kora Refunds API

Refunds for completed pay-in transactions.

Kora Refunds API is one of 7 APIs that Kora publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Refunds. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 3 operations across 3 paths, and defines 3 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.korapay.com/merchant/api/v1.

3 operations 3 paths 3 schemas 2 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.korapay.com/merchant/api/v1
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Kora Refunds API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (secretKeyAuth). It accepts HTTP bearer tokens (publicKeyAuth). By default, every request must be authenticated.

  • secretKeyAuth — Secret API key passed as Authorization: Bearer sk.... Required for server-side and financial operations (payouts, balances, virtual bank accounts, refunds, con…
  • publicKeyAuth — Public API key (pk...) used from client-side code to initiate charges. Cannot access financial data.

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Refunds 3

Refunds for completed pay-in transactions.

POST
/refunds/initiate
Initiate a refund
initiateRefund body → 200401
GET
/refunds/{reference}
Retrieve a refund
getRefund 1 param → 200401404
GET
/refunds
List refunds
listRefunds 4 params → 200401

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are RefundInput (4 properties), ErrorResponse (3 properties), RefundResponse (3 properties). Each schema is shown below with its type and property counts.

RefundResponse
object
3 properties
RefundInput
object
4 properties 2 required
ErrorResponse
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

korapay-refunds-api-openapi.yml Raw ↑

Other APIs Kora publishes across the network.

Kora Balances API
Kora Charges API
Kora Currency Conversion API
Kora Misc API
Kora Payouts API
Kora Virtual Bank Accounts API