> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archefusion.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get payment details

> This endpoint retrieves the details of a specific payment by ID.



## OpenAPI

````yaml /archefusion-openapi.yaml get /v1/payments/{paymentId}
openapi: 3.0.0
info:
  title: OpenAPI Spec
  version: 1.0.0
  description: ''
servers:
  - url: https://dev.api-gateway.archefusion.com
security: []
tags:
  - name: Payments
paths:
  /v1/payments/{paymentId}:
    parameters:
      - name: paymentId
        in: path
        required: true
        description: >-
          This represents the payment ID. You can retrieve it from the paymentId
          field in the `initiate payment` response, or from the redirect URL
          after the customer completes payment.
        schema:
          type: string
        example: 0b6702ee-6f78-40a6-8216-54c347f0971b
    get:
      tags:
        - Payments
      summary: Get payment details
      description: This endpoint retrieves the details of a specific payment by ID.
      responses:
        '200':
          description: Success
          headers:
            Access-Control-Allow-Origin:
              schema:
                type: string
              example: '*'
            Content-Length:
              schema:
                type: integer
              example: 3137
            Date:
              schema:
                type: string
              example: Tue, 26 May 2026 07:53:09 GMT
            Etag:
              schema:
                type: string
              example: W/"c41-PizBw91tcx62qzamaOIUrcA2Byc"
            X-Archefusion-Service:
              schema:
                type: string
              example: api-gateway
            X-Powered-By:
              schema:
                type: string
              example: Express
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  statusCode:
                    type: integer
                    example: 200
                  message:
                    type: string
                    example: ok
                  data:
                    type: object
                    properties:
                      paymentId:
                        type: string
                        description: >-
                          The unique Archefusion payment ID for this
                          transaction.
                        example: 59049e67-b607-49df-87dd-6dc52b944df0
                      merchantOrderId:
                        type: string
                        description: >-
                          The unique order ID you provided when initiating the
                          payment.
                        example: order-34543
                      status:
                        type: string
                        description: >-
                          The current payment status. Possible values: PENDING,
                          SUCCESS, FAILED.
                        example: SUCCESS
                      executionStatus:
                        type: string
                        description: The internal processing status of the payment.
                        example: succeeded
                      currency:
                        type: string
                        example: NGN
                      amount:
                        type: integer
                        description: The payment amount in the main currency unit.
                        example: 5000
                      recommendedGateway:
                        type: object
                        description: The gateway Archefusion routed this payment to.
                        properties:
                          name:
                            type: string
                            example: paystack
                          session:
                            type: object
                            description: The gateway session details.
                            properties:
                              raw:
                                type: object
                                description: The raw response returned by the gateway.
                                properties:
                                  reference:
                                    type: string
                                    example: >-
                                      paystack_59049e67-b607-49df-87dd-6dc52b944df0
                                  access_code:
                                    type: string
                                    example: cr1x389nicvfily
                                  authorization_url:
                                    type: string
                                    example: >-
                                      https://checkout.paystack.com/cr1x389nicvfily
                              gateway:
                                type: string
                                example: paystack
                              reference:
                                type: string
                                example: paystack_59049e67-b607-49df-87dd-6dc52b944df0
                              accessCode:
                                type: string
                                example: cr1x389nicvfily
                              redirectUrl:
                                type: string
                                example: https://checkout.paystack.com/cr1x389nicvfily
                              metadata:
                                type: object
                                properties:
                                  mode:
                                    type: string
                                    example: test
                                  paymentId:
                                    type: string
                                    example: 59049e67-b607-49df-87dd-6dc52b944df0
                                  merchantId:
                                    type: string
                                    example: 0c89458a-fb09-48ba-91a9-ab697d76be61
                                  callbackUrl:
                                    type: string
                                    example: https://www.archefusion.com
                                  redirectUrl:
                                    type: string
                                    example: https://www.archefusion.com
                                  merchantOrderId:
                                    type: string
                                    example: order-34543
                                  referencePrefix:
                                    type: string
                                    example: ''
                                  fallbackGateways:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        name:
                                          type: string
                                          example: paystack
                                        reason:
                                          type: string
                                          example: plan-fallback
                      fallbackGateways:
                        type: array
                        description: >-
                          The list of fallback gateways if the recommended
                          gateway fails.
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              example: paystack
                            reason:
                              type: string
                              example: plan-fallback
                      routing:
                        type: object
                        description: The routing decision details for this payment.
                        properties:
                          version:
                            type: integer
                            example: 2
                          decidedAt:
                            type: string
                            format: date-time
                            example: '2026-05-26T07:43:12.584Z'
                          rationale:
                            type: string
                            example: >-
                              Matched smart routing rule "New rule"
                              (priority=1).
                          rationaleCode:
                            type: string
                            example: smart_routing_rule
                          contextKey:
                            type: string
                            example: NGN|CARD|5000-10000
                          overrides:
                            type: array
                            items:
                              type: object
                          reasons:
                            type: array
                            items:
                              type: object
                              properties:
                                code:
                                  type: string
                                  example: smart_routing_rule
                                title:
                                  type: string
                                  example: Merchant routing rule matched
                                message:
                                  type: string
                                  example: >-
                                    A smart routing rule matched this
                                    transaction context, so the provider order
                                    follows the merchant-configured precedence
                                    (subject to policy and health overrides).
                                category:
                                  type: string
                                  example: rule
                                severity:
                                  type: string
                                  example: info
                          candidates:
                            type: array
                            items:
                              type: object
                              properties:
                                index:
                                  type: integer
                                  example: 0
                                eligible:
                                  type: boolean
                                  example: true
                                provider:
                                  type: string
                                  example: paystack
                                subproviderId:
                                  type: string
                                  example: PAYSTACK_NGN_CARD_5000_10000
                                ineligibleReason:
                                  type: string
                                  nullable: true
                                  example: null
                          recommended:
                            type: object
                            properties:
                              index:
                                type: integer
                                example: 0
                              provider:
                                type: string
                                example: paystack
                              subproviderId:
                                type: string
                                example: PAYSTACK_NGN_CARD_5000_10000
                      createdAt:
                        type: string
                        format: date-time
                        example: '2026-05-26T07:43:12.585Z'
                      updatedAt:
                        type: string
                        format: date-time
                        example: '2026-05-26T07:52:09.855Z'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  statusCode:
                    type: integer
                    example: 401
                  message:
                    type: string
                    example: Invalid API key
                  data:
                    nullable: true
                    example: null
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  statusCode:
                    type: integer
                    example: 404
                  message:
                    type: string
                    example: Payment not found
                  data:
                    nullable: true
                    example: null
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````