openapi: 3.1.0
info:
  title: Synchrony Financial Credit Authorization Applications Refunds API
  description: The Synchrony Financial Credit Authorization API allows merchants and retailers to perform credit card transactions including purchases, preauthorizations, completions, payments, refunds, and reversals. The API supports transactions via payment tokens or full account numbers across web, mobile, and point-of-sale channels.
  version: '1.0'
  contact:
    url: https://developer.syf.com/
servers:
- url: https://api.syf.com
  description: Production
- url: https://sandbox.api.syf.com
  description: Sandbox
security:
- bearerAuth: []
tags:
- name: Refunds
  description: Process refunds and credit adjustments.
paths:
  /v1/authorizations/refunds:
    post:
      operationId: createRefund
      summary: Create Refund
      description: Processes a refund to a customer's Synchrony credit account, crediting the specified amount back to the account.
      tags:
      - Refunds
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RefundRequest'
      responses:
        '200':
          description: Refund processed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthorizationResponse'
        '400':
          description: Bad request
components:
  schemas:
    RefundRequest:
      type: object
      required:
      - merchantId
      - originalTransactionId
      - amount
      properties:
        merchantId:
          type: string
        originalTransactionId:
          type: string
        amount:
          type: number
          format: float
    AuthorizationResponse:
      type: object
      properties:
        transactionId:
          type: string
          description: Unique identifier for the transaction.
        authorizationCode:
          type: string
          description: Authorization code returned on approval.
        status:
          type: string
          enum:
          - approved
          - declined
          - pending
        amount:
          type: number
          format: float
        accountNumber:
          type: string
          description: Masked account number.
        timestamp:
          type: string
          format: date-time
        message:
          type: string
          description: Human-readable status message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer