v1

latestOpenAPI 3.0.02026-07-1412068.2 KB
Transactions

Fetch Transaction Info

This API enables you to retrieve detailed information about a specific charge by providing the charge ID.<br>It is designed to give you a comprehensive view of transaction details.<br><br>

get/charges/{chargeId}

Path parameters

chargeIdstring required

Transaction ID / Charge ID

Headers

Content-Typestring
Authorizationstring

Response

Successful response

status'confirmation_required' | 'captured' | 'refund_initiated' | 'processing' | 'failed' | 'refunded'
idstring
amountnumber
amount_currencystring
refund_amountnumber
refund_statusstring
billing_descriptorstring
custom_dataobject
created_datestring
subscription_idstring

Value is set for subscriptions only. For one-time payments, this will be null.

next_payment_datestring

Value is set for subscriptions only. For one-time payments, this will be null.

settlement_amountnumber
settlement_currencystring
settlement_datestring
error_codestring
error_messagestring

Example response

{
  "status": "captured",
  "id": "MPB-CHRG-E0CE93E071",
  "amount": 100,
  "amount_currency": "AED",
  "refund_amount": 0,
  "refund_status": "No refund",
  "billing_descriptor": "Mamo*Merchant",
  "custom_data": {
    "internal_customer_id": "0114120d-c394-4cce-9cdb-4ccbae605748",
    "val1": true,
    "val2": "custom value"
  },
  "created_date": "2023-05-31-11-18-57",
  "subscription_id": "MPB-SUB-B764EDCBA2",
  "next_payment_date": "05/06/2023",
  "settlement_amount": 356.42,
  "settlement_currency": "AED",
  "settlement_date": "05/06/2023",
  "customer_details": {
    "name": "Mamo User",
    "email": "email@mamopay.com",
    "phone_number": "+971551234567",
    "comment": "Dolore voluptate possimus et."
  },
  "payment_method": {
    "type": "CREDIT VISA",
    "card_holder_name": "Mamo User",
    "card_last4": "•••• 4242",
    "origin": "UAE card"
  },
  "error_code": "generic",
  "error_message": "Unknown reason - user should contact their bank to find out"
}