---
updatedAt: 2025-11-11T00:09:38.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/v1.1/llms.txt
---

# Generate Alternative Payment Options

This endpoint allows you to generate a list of alternative payment options for a transaction based on the customer’s preferences and the merchant’s capabilities.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "accept-payments-new",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://qa.interswitchng.com"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/collections/api/v1/sdk/merchant-details": {
      "get": {
        "summary": "Generate Alternative Payment Options",
        "description": "This endpoint allows you to generate a list of alternative payment options for a transaction based on the customer’s preferences and the merchant’s capabilities.",
        "operationId": "generate-alternative-payment-options",
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "application/json"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "schema": {
              "type": "string",
              "default": "Bearer eyJhbGciOiJSUzI1NiJ9.eyJhdWQiOlsiaXN3LWNvbGxlY3Rpb25zIiwiaXN3LXBheW1lbnRnYXRld2F5IiwicGFzc3BvcnQiLCJwcm9qZWN0LXgtbWVyY2hhbnQiLCJ2YXVsdCJdLCJtZXJjaGFudF9jb2RlIjoiTVg2MDcyIiwicmVxdWVzdG9yX2lkIjoiMTIzODA4NTk1MDMiLCJzY29wZSI6WyJwcm9maWxlIl0sImp0aSI6IjVkOTczM2Y5LWMzNDEtNGFjZC04ZjE3LWViYzUyYWE0NjM2MiIsInBheWFibGVfaWQiOiIzMzU5NyIsImNsaWVudF9pZCI6IklLSUFCMjNBNEUyNzU2NjA1QzFBQkMzM0NFM0MyODdFMjcyNjdGNjYwRDYxIn0.ElgBX2KoF9LuUUpeBGzzp8CDAllTHWfgM6pJRgTtPYGJpoZufKlJrmE4QTvZV6MIVaNtK21majTgR4qXJr7CEkPK_4zCIHyN2b8a445vqhLYcbffQvK4EeUn_RzsWTmub2bruG5s4bRS1il5itPR0QQ-trEsbELU7TAHvC4p786RiAQd-K_I0bwtLzIXQN65jlw3eJxxK-BGfca-OMTUo9HGvraebfLB-7h4-vNbPred58gfLBSwK31jaLP19cMRc5Jea28jrlmGNUhHGzjnP7ZanqgC9uuvoepQsa39_DNBonR6xirxKw4aNlNLcKOTn026wyOTHIHUGlDQ3s3AOQ"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"merchant\": {\n        \"name\": \"sadd\",\n        \"merchantCode\": \"MX6072\",\n        \"logoUrl\": \"https://mufasa-qa.interswitchng.com/p/projectxmerchant/images/logos/MX6072/MX6072_1630932696873.jpg\",\n        \"corporateApprovalStatus\": 3,\n        \"settlementType\": 0\n    },\n    \"paymentOptions\": [\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"CARD\",\n            \"enabled\": true,\n            \"additionalInformation\": null\n        },\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"QR\",\n            \"enabled\": true,\n            \"additionalInformation\": null\n        },\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"USSD\",\n            \"enabled\": true,\n            \"additionalInformation\": null\n        },\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"PYC\",\n            \"enabled\": true,\n            \"additionalInformation\": {\n                \"supportedCountry\": \"NG\",\n                \"providers\": [\n                    {\n                        \"id\": 2002,\n                        \"paymentLabel\": \"Pay with paycode\",\n                        \"requiredPaymentFields\": {\n                            \"VALIDATION\": \"\",\n                            \"PURCHASE\": \"pin\"\n                        },\n                        \"supportsCallback\": false,\n                        \"providerId\": \"paycode\",\n                        \"categoryCode\": \"PYC\",\n                        \"esbRoute\": \"default\",\n                        \"enabled\": true,\n                        \"provider\": {\n                            \"id\": 2010,\n                            \"institutionCode\": \"941\",\n                            \"providerId\": \"paycode\",\n                            \"categoryId\": 1002\n                        },\n                        \"country\": \"NG\"\n                    }\n                ]\n            }\n        },\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"TRANSFER\",\n            \"enabled\": true,\n            \"additionalInformation\": null\n        },\n        {\n            \"payableCode\": \"9405967\",\n            \"providerCode\": \"CRD\",\n            \"enabled\": true,\n            \"additionalInformation\": {\n                \"supportedCountry\": \"NG\",\n                \"supportedCardTypeCodes\": [\n                    \"MCN\",\n                    \"VVC\",\n                    \"MCC\"\n                ],\n                \"providers\": [\n                    {\n                        \"id\": 4002,\n                        \"paymentLabel\": \"Pay with Credit\",\n                        \"supportsCallback\": false,\n                        \"providerId\": \"credit\",\n                        \"categoryCode\": \"CRD\",\n                        \"esbRoute\": \"default\",\n                        \"enabled\": true,\n                        \"provider\": {\n                            \"id\": 4013,\n                            \"institutionCode\": \"900\",\n                            \"providerId\": \"credit\",\n                            \"categoryId\": 3002\n                        },\n                        \"position\": 1,\n                        \"country\": \"NG\"\n                    }\n                ]\n            }\n        }\n    ]\n}\t"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "merchant": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "example": "sadd"
                        },
                        "merchantCode": {
                          "type": "string",
                          "example": "MX6072"
                        },
                        "logoUrl": {
                          "type": "string",
                          "example": "https://mufasa-qa.interswitchng.com/p/projectxmerchant/images/logos/MX6072/MX6072_1630932696873.jpg"
                        },
                        "corporateApprovalStatus": {
                          "type": "integer",
                          "example": 3,
                          "default": 0
                        },
                        "settlementType": {
                          "type": "integer",
                          "example": 0,
                          "default": 0
                        }
                      }
                    },
                    "paymentOptions": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "payableCode": {
                            "type": "string",
                            "example": "9405967"
                          },
                          "providerCode": {
                            "type": "string",
                            "example": "CARD"
                          },
                          "enabled": {
                            "type": "boolean",
                            "example": true,
                            "default": true
                          },
                          "additionalInformation": {}
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```