---
updatedAt: 2025-03-13T20:26:40.000Z
agentTools:
  projectIndex: https://mifinity.readme.io/llms.txt
---

# Payment Status

This API is used to get status of SGPG payment.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "payment-status",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://demo.mifinity.com/api/gateway/payment-status/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/{validationKey}": {
      "get": {
        "summary": "Payment Status",
        "description": "This API is used to get status of SGPG payment.",
        "operationId": "payment-status",
        "parameters": [
          {
            "name": "validationKey",
            "in": "path",
            "description": "Secret key used in Initialize SGPG Iframe (Path Variable)",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"payload\": [\n    {\n      \"status\": \"SUCCESSFUL\",\n      \"paymentResponse\": {\n        \"sourceMoney\": {\n          \"amount\": 150,\n          \"currency\": \"EUR\",\n          \"presentationAmount\": \"EUR150.00\"\n        },\n        \"destinationMoney\": {\n          \"amount\": 150,\n          \"currency\": \"EUR\",\n          \"presentationAmount\": \"EUR150.00\"\n        },\n        \"totalFees\": {\n          \"amount\": 0,\n          \"currency\": \"EUR\",\n          \"presentationAmount\": \"EUR0.00\"\n        },\n        \"traceId\": \"traceIdASRQLThiunztFWhckw6t2\",\n        \"money\": {\n          \"amount\": 150,\n          \"currency\": \"EUR\",\n          \"presentationAmount\": \"EUR150.00\"\n        },\n        \"description\": \"Test\",\n        \"clientReference\": \"Sherlock Holmes\",\n        \"validationKey\": \"Gxx4o3r8OR2E372hHxtpW7mOjGvOa81EXGhz~luUXKsUbwGGd5oaiP5IHCEUxblV1XLGNKXbhYCQgAPhTHgLAcWEWpz1JiIRbeFP5YNlA3FVW~XYrhZsnq5uo4Zw\",\n        \"responseCode\": \"FnUVNoes9jwyI7V7gdQvovRMbM966WR1a2QAh3pj3LY=\",\n        \"transactionReference\": \"79da2eee-bc4d-4712-a6fa-6dc8c8088b1a\",\n        \"paymentType\": \"EWALLET\",\n        \"customerAccountNumber\": \"5001000001213949\",\n        \"customerDob\": \"1993-10-31\",\n        \"customerFirstName\": \"anish\",\n        \"customerLastName\": \"shah\",\n        \"senderEmailAddress\": \"tmifinity+ashah2@gmail.com\",\n        \"paymentMethod\": \"giropay\",\n        \"accountNumber\": \"500100XXXXXX3949\",\n        \"customerCountryCode\": \"DE\",\n        \"requestedMoney\": {\n          \"amount\": 150,\n          \"currency\": \"EUR\",\n          \"presentationAmount\": \"EUR150.00\"\n        }\n      }\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "payload": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "status": {
                            "type": "string",
                            "example": "SUCCESSFUL"
                          },
                          "paymentResponse": {
                            "type": "object",
                            "properties": {
                              "sourceMoney": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "integer",
                                    "example": 150,
                                    "default": 0
                                  },
                                  "currency": {
                                    "type": "string",
                                    "example": "EUR"
                                  },
                                  "presentationAmount": {
                                    "type": "string",
                                    "example": "EUR150.00"
                                  }
                                }
                              },
                              "destinationMoney": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "integer",
                                    "example": 150,
                                    "default": 0
                                  },
                                  "currency": {
                                    "type": "string",
                                    "example": "EUR"
                                  },
                                  "presentationAmount": {
                                    "type": "string",
                                    "example": "EUR150.00"
                                  }
                                }
                              },
                              "totalFees": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "integer",
                                    "example": 0,
                                    "default": 0
                                  },
                                  "currency": {
                                    "type": "string",
                                    "example": "EUR"
                                  },
                                  "presentationAmount": {
                                    "type": "string",
                                    "example": "EUR0.00"
                                  }
                                }
                              },
                              "traceId": {
                                "type": "string",
                                "example": "traceIdASRQLThiunztFWhckw6t2"
                              },
                              "money": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "integer",
                                    "example": 150,
                                    "default": 0
                                  },
                                  "currency": {
                                    "type": "string",
                                    "example": "EUR"
                                  },
                                  "presentationAmount": {
                                    "type": "string",
                                    "example": "EUR150.00"
                                  }
                                }
                              },
                              "description": {
                                "type": "string",
                                "example": "Test"
                              },
                              "clientReference": {
                                "type": "string",
                                "example": "Sherlock Holmes"
                              },
                              "validationKey": {
                                "type": "string",
                                "example": "Gxx4o3r8OR2E372hHxtpW7mOjGvOa81EXGhz~luUXKsUbwGGd5oaiP5IHCEUxblV1XLGNKXbhYCQgAPhTHgLAcWEWpz1JiIRbeFP5YNlA3FVW~XYrhZsnq5uo4Zw"
                              },
                              "responseCode": {
                                "type": "string",
                                "example": "FnUVNoes9jwyI7V7gdQvovRMbM966WR1a2QAh3pj3LY="
                              },
                              "transactionReference": {
                                "type": "string",
                                "example": "79da2eee-bc4d-4712-a6fa-6dc8c8088b1a"
                              },
                              "paymentType": {
                                "type": "string",
                                "example": "EWALLET"
                              },
                              "customerAccountNumber": {
                                "type": "string",
                                "example": "5001000001213949"
                              },
                              "customerDob": {
                                "type": "string",
                                "example": "1993-10-31"
                              },
                              "customerFirstName": {
                                "type": "string",
                                "example": "anish"
                              },
                              "customerLastName": {
                                "type": "string",
                                "example": "shah"
                              },
                              "senderEmailAddress": {
                                "type": "string",
                                "example": "tmifinity+ashah2@gmail.com"
                              },
                              "paymentMethod": {
                                "type": "string",
                                "example": "giropay"
                              },
                              "accountNumber": {
                                "type": "string",
                                "example": "500100XXXXXX3949"
                              },
                              "customerCountryCode": {
                                "type": "string",
                                "example": "DE"
                              },
                              "requestedMoney": {
                                "type": "object",
                                "properties": {
                                  "amount": {
                                    "type": "integer",
                                    "example": 150,
                                    "default": 0
                                  },
                                  "currency": {
                                    "type": "string",
                                    "example": "EUR"
                                  },
                                  "presentationAmount": {
                                    "type": "string",
                                    "example": "EUR150.00"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"errors\": [\n    {\n      \"type\": \"FATAL\",\n      \"errorCode\": \"TRANSACTION_FAILED\",\n      \"message\": \"Transaction Declined: Incorrect validation key. No records were found\",\n      \"field\": \"Incorrect validation key. No records were found\"\n    }\n  ]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string",
                            "example": "FATAL"
                          },
                          "errorCode": {
                            "type": "string",
                            "example": "TRANSACTION_FAILED"
                          },
                          "message": {
                            "type": "string",
                            "example": "Transaction Declined: Incorrect validation key. No records were found"
                          },
                          "field": {
                            "type": "string",
                            "example": "Incorrect validation key. No records were found"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "api-version",
        "value": "1"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```