m2pfintech
API LibraryStatus

Fetch Transaction Status

Retrieve the current status and details of a previously submitted transaction (OCT push, AFT pull, bill payment, etc.) using the partner's external transaction ID.

  • Method: GET
  • Path parameter: externalTransactionId — the unique ID supplied in the original transaction request
  • No request body required
  • senderCardNo is returned masked (e.g., 4012XXXXXXXX1112)

txnStatus values:

  • PAYMENT_SUCCESS — Transaction approved and settled
  • PAYMENT_FAILURE — Transaction declined or failed
  • IN_PROCESS — Transaction is still being processed (e.g., 3DS pending)
  • REVERSAL_SUCCESS — Reversal completed successfully
GET
/txn-manager/v2/fetch/{externalTransactionId}

Authorization

BasicAuth
AuthorizationBasic <token>

Partner credentials (username/password) provisioned during onboarding

In: header

Path Parameters

externalTransactionId*string

The unique external transaction ID provided in the original transaction request

Response Body

application/json

application/json

application/json

curl -X GET "https://secure.yappay.in/Yappay/txn-manager/v2/fetch/EXT-M2P-348"

{
  "result": {
    "txnDate": "2026-04-14 19:15:31",
    "businessEntityId": null,
    "networkType": "VISA",
    "senderCardNo": "4012XXXXXXXX1112",
    "externalTxnId": "EXT-M2P-348",
    "description": "Visa Payment",
    "amount": 100.5,
    "rrn": "601419123978",
    "authCode": "032632",
    "txnType": "AFT_PULL",
    "txnStatus": "PAYMENT_SUCCESS",
    "statusReason": "APPROVED",
    "originalStatus": null,
    "networkReason": "00 : Approved and completed successfully"
  },
  "exception": null,
  "pagination": null
}

{
  "result": {},
  "exception": {
    "errorCode": "Y701",
    "code": "transfer.eligibility.check.failed",
    "shortMessage": "Eligibility check failed",
    "detailMessage": "Eligibility check failed",
    "languageCode": "en",
    "fieldErrors": [
      "API Validation Error: 3001. Invalid Account"
    ],
    "networkHttpStatusCode": 0,
    "cause": {},
    "message": "string",
    "localizedMessage": "string",
    "suppressed": [
      {}
    ]
  },
  "pagination": {}
}
{
  "result": null,
  "error": {
    "errorCode": "INTERNAL_ERROR",
    "shortMessage": "Internal server error",
    "detailMessage": "An unexpected error occurred. Please contact support."
  }
}

Push Funds to Card (OCT) POST

Send money instantly to any Visa or Mastercard (Original Credit Transaction). **Use Cases**: - Person-to-Person (P2P) transfers - Merchant payouts and disbursements - Insurance disbursements - Refunds and cashback **Features**: - Auto-routes to Visa Direct or Mastercard Send based on card BIN - Real-time / near-real-time settlement - Supports cross-border transfers - Fast Funds (< 30 sec) for eligible cards > **⚠️ Important**: The response from this API indicates only whether the request was > accepted. **Do not rely on this response to determine final transaction status.** > Always call `GET /Yappay/txn-manager/v2/fetch/{externalTransactionId}` to confirm > the final `txnStatus` (e.g., `PAYMENT_SUCCESS`, `PAYMENT_FAILURE`).