Johrh

Johrh Payments API

The Payments API from Johrh — 19 operation(s) for payments.

GitHub OpenAPI

Documentation

📖
APIReference
https://johrh.com/openapi.json

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/johrh/refs/heads/main/openapi/johrh-payments-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/johrh/refs/heads/main/errors/johrh-problem-types.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/johrh-payments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

johrh-payments-api-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Vitrin Account Payments API
  version: 2026.2.23
tags:
- name: Payments
paths:
  /checkout/{payment_token}/tabby/success:
    get:
      tags:
      - Payments
      summary: Handle Tabby Success
      operationId: handle_tabby_success_checkout__payment_token__tabby_success_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      - name: payment_id
        in: query
        required: true
        schema:
          type: string
          title: Payment Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tamara/success:
    get:
      tags:
      - Payments
      summary: Handle Tamara Success
      operationId: handle_tamara_success_checkout__payment_token__tamara_success_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      - name: orderId
        in: query
        required: true
        schema:
          type: string
          title: Orderid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/emkan/success:
    get:
      tags:
      - Payments
      summary: Handle Emkan Success
      operationId: handle_emkan_success_checkout__payment_token__emkan_success_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/madfu/failure:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__madfu_failure_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/emkan/failure:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__emkan_failure_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tamara/failure:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__tamara_failure_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tabby/failure:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__tabby_failure_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/emkan/cancel:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__emkan_cancel_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tamara/cancel:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__tamara_cancel_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tabby/cancel:
    get:
      tags:
      - Payments
      summary: Handle Payment Failure
      operationId: handle_payment_failure_checkout__payment_token__tabby_cancel_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/zidpay/callback:
    get:
      tags:
      - Payments
      summary: Handle Zidpay Success
      operationId: handle_zidpay_success_checkout__payment_token__zidpay_callback_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      - name: paymentReferenceId
        in: query
        required: true
        schema:
          type: string
          title: Paymentreferenceid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/zidpay/error:
    get:
      tags:
      - Payments
      summary: Handle Zidpay Failure
      operationId: handle_zidpay_failure_checkout__payment_token__zidpay_error_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      - name: paymentReferenceId
        in: query
        required: true
        schema:
          type: string
          title: Paymentreferenceid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/from-token:
    get:
      tags:
      - Payments
      summary: Get Checkout Token
      description: The endpoint used by mobile apps to correctly use the checkout mobile webview. apps that use vitrin APIs for cart operations do not need this.
      operationId: get_checkout_token_checkout_from_token_get
      deprecated: true
      parameters:
      - name: checkout-token
        in: query
        required: true
        schema:
          type: string
          title: Checkout-Token
      - name: source
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Source
      - name: lang
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Lang
      - name: country
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Country
      - name: currency
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Currency
      - name: city
        in: query
        required: false
        schema:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: City
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /mis-callback:
    get:
      tags:
      - Payments
      summary: Handle Mispay Callback
      operationId: handle_mispay_callback_mis_callback_get
      parameters:
      - name: _
        in: query
        required: true
        schema:
          type: string
          title: ' '
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/madfu/success:
    get:
      tags:
      - Payments
      summary: Handle Madfu Success
      operationId: handle_madfu_success_checkout__payment_token__madfu_success_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/madfu/cancel:
    get:
      tags:
      - Payments
      summary: Handle Madfu Cancel
      operationId: handle_madfu_cancel_checkout__payment_token__madfu_cancel_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tap/callback:
    get:
      tags:
      - Payments
      summary: Handle Tap Callback
      description: Handle Tap payment redirect callback
      operationId: handle_tap_callback_checkout__payment_token__tap_callback_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      - name: tap_id
        in: query
        required: false
        schema:
          type: string
          title: Tap Id
      - name: id
        in: query
        required: false
        schema:
          type: string
          title: Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tap/cancel:
    get:
      tags:
      - Payments
      summary: Handle Tap Failure
      operationId: handle_tap_failure_checkout__payment_token__tap_cancel_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /checkout/{payment_token}/tap/failure:
    get:
      tags:
      - Payments
      summary: Handle Tap Failure
      operationId: handle_tap_failure_checkout__payment_token__tap_failure_get
      parameters:
      - name: payment_token
        in: path
        required: true
        schema:
          type: string
          title: Payment Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError