{"openapi":"3.0.1","info":{"title":"Noxa Payments API","description":"Server-to-server pay-in API. Authenticate with X-Api-Key: keyId:secret. Merchant-safe responses never include the underlying provider.","version":"v1"},"servers":[{"url":"https://api-collections.swcindia.online","description":"API"},{"url":"http://localhost:8090","description":"Local"}],"paths":{"/api/v1/routing/payout/decide":{"post":{"tags":["UPI Routing Engine"],"summary":"Select MID+Gateway for a UPI payout","operationId":"decidePayout","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecideRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/api/v1/routing/payin/decide":{"post":{"tags":["UPI Routing Engine"],"summary":"Select MID+Gateway for a UPI payin","operationId":"decidePayin","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecideRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/api/v1/routing/decisions/{decisionId}/outcome":{"post":{"tags":["UPI Routing Engine"],"summary":"Report transaction outcome for a routing decision","operationId":"outcome","parameters":[{"name":"decisionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/api/v1/routing/decide":{"post":{"tags":["UPI Routing Engine"],"summary":"Select a gateway/MID for this transaction (routing-only and full-platform)","operationId":"decide","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecideRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/api/v1/routing/decisions":{"get":{"tags":["UPI Routing Engine"],"operationId":"byRef","parameters":[{"name":"transactionRef","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}},"/api/v1/routing/decisions/{decisionId}":{"get":{"tags":["UPI Routing Engine"],"operationId":"get","parameters":[{"name":"decisionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}}}}}},"components":{"schemas":{"Customer":{"type":"object","properties":{"vpa":{"type":"string"},"customerId":{"type":"string"}}},"DecideRequest":{"required":["amount"],"type":"object","properties":{"transactionRef":{"type":"string"},"amount":{"type":"number"},"currency":{"type":"string"},"idempotencyKey":{"type":"string"},"customer":{"$ref":"#/components/schemas/Customer"},"paymentMethod":{"type":"string","enum":["UPI","UPI_INTENT","UPI_COLLECT","CARD","NETBANKING","WALLET","EMI","UPI_POOL"]},"excludedGateways":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"ipAddress":{"type":"string"},"customerRef":{"type":"string"},"deviceFingerprint":{"type":"string"},"orderReference":{"type":"string"}}},"OutcomeRequest":{"type":"object","properties":{"status":{"type":"string"},"pspErrorCode":{"type":"string"},"completedAt":{"type":"string","format":"date-time"}}}},"securitySchemes":{"apiKey":{"type":"apiKey","name":"X-Api-Key","in":"header"}}}}