Mangopay Payment methods API

openapi: 3.0.3
info:
  title: Mangopay REST Bank Accounts Payment methods API
  description: The Mangopay REST API enables platforms to manage users, e-wallets, pay-ins, payouts, transfers, foreign exchange, KYC/KYB identity verification, fraud prevention, and dispute handling for multi-party payment flows.
  version: '2.01'
  contact:
    name: Mangopay Support
    url: https://hub.mangopay.com
servers:
- url: https://api.mangopay.com/v2.01/{clientId}
  description: Production
  variables:
    clientId:
      default: your-client-id
      description: Your Mangopay Client ID
- url: https://api.sandbox.mangopay.com/v2.01/{clientId}
  description: Sandbox
  variables:
    clientId:
      default: your-client-id
      description: Your Mangopay Client ID
security:
- OAuth2: []
tags:
- name: Payment methods
paths:
  /cardregistrations:
    post:
      tags:
      - Payment methods
      summary: Create a Card Registration
      operationId: post_cardregistrations
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#create-card-registration](https://mangopay.com/docs/endpoints/direct-card-payins#create-card-registration)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              UserId: '{{USER_NATURAL_PAYER}}'
              Currency: '{{CURRENCY}}'
              CardType: CB_VISA_MASTERCARD
  '{cardregistrationurl}':
    post:
      tags:
      - Payment methods
      summary: Tokenize the Card (Challenge Flow Card)
      operationId: post_cardregistrationurl
      parameters:
      - name: cardregistrationurl
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#tokenize-card](https://mangopay.com/docs/endpoints/direct-card-payins#tokenize-card)'
  /cardregistrations/{cardregistrationid}:
    put:
      tags:
      - Payment methods
      summary: Update a Card Registration
      operationId: put_cardregistrations_cardregistrationid
      parameters:
      - name: cardregistrationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#update-card-registration](https://mangopay.com/docs/endpoints/direct-card-payins#update-card-registration)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              RegistrationData: '{{REGISTRATION_DATA_KEY}}'
    get:
      tags:
      - Payment methods
      summary: View a Card Registration
      operationId: get_cardregistrations_cardregistrationid
      parameters:
      - name: cardregistrationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#view-card-registration](https://mangopay.com/docs/endpoints/direct-card-payins#view-card-registration)'
  /cards/{cardchallengeflowid}:
    put:
      tags:
      - Payment methods
      summary: Deactivate a card
      operationId: put_cards_cardchallengeflowid
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#deactivate-card](https://mangopay.com/docs/endpoints/direct-card-payins#deactivate-card)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              Active: false
    get:
      tags:
      - Payment methods
      summary: View a Card
      operationId: get_cards_cardchallengeflowid
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#view-card](https://mangopay.com/docs/endpoints/direct-card-payins#view-card)'
  /users/{userId}/cards:
    get:
      tags:
      - Payment methods
      summary: List Cards for a User
      operationId: get_users_userId_cards
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#list-cards-user](https://mangopay.com/docs/endpoints/direct-card-payins#list-cards-user)'
  /cards/fingerprints/{cardfingerprint}:
    get:
      tags:
      - Payment methods
      summary: List Cards for a Fingerprint
      operationId: get_cards_fingerprints_cardfingerprint
      parameters:
      - name: cardfingerprint
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#list-cards-fingerprint](https://mangopay.com/docs/endpoints/direct-card-payins#list-cards-fingerprint)'
  /cards/fingerprints/{cardfingerprint}/transactions:
    get:
      tags:
      - Payment methods
      summary: List Transactions for a Card Fingerprint
      operationId: get_cards_fingerprints_cardfingerprint_transactions
      parameters:
      - name: cardfingerprint
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#list-transactions-card-fingerprint](https://mangopay.com/docs/endpoints/direct-card-payins#list-transactions-card-fingerprint)'
  /cards/{cardchallengeflowid}/validation:
    post:
      tags:
      - Payment methods
      summary: Create a Card Validation
      operationId: post_cards_cardchallengeflowid_validation
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/card-validations#create-card-validation](https://mangopay.com/docs/endpoints/card-validations#create-card-validation)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              AuthorId: '{{USER_NATURAL_PAYER}}'
              SecureModeReturnURL: https://mangopay.com/docs/please-ignore
              IpAddress: '{{$randomIPV6}}'
              Tag: Created using the Mangopay API Postman collection
              BrowserInfo:
                AcceptHeader: application/json,text/javascript,*/*;q=0.01<
                JavaEnabled: true
                Language: fr
                ColorDepth: 32
                ScreenHeight: 667
                ScreenWidth: 375
                TimeZoneOffset: '-120'
                UserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
                JavascriptEnabled: true
  /cards/{cardchallengeflowid}/validation/{cardvalidationid}:
    get:
      tags:
      - Payment methods
      summary: View a Card Validation
      operationId: get_cards_cardchallengeflowid_validation_cardvalidationid
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      - name: cardvalidationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/card-validations#view-card-validation](https://mangopay.com/docs/endpoints/card-validations#view-card-validation)'
  /payins/card/direct:
    post:
      tags:
      - Payment methods
      summary: Create a Card Direct PayIn
      operationId: post_payins_card_direct
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#create-direct-card-payin](https://mangopay.com/docs/endpoints/direct-card-payins#create-direct-card-payin)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              AuthorId: '{{USER_NATURAL_PAYER}}'
              CreditedUserId: '{{USER_NATURAL_PAYER}}'
              CreditedWalletId: '{{USER_NATURAL_PAYER_WALLET_ID}}'
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 10
              Fees:
                Currency: '{{CURRENCY}}'
                Amount: 0
              SecureModeReturnURL: https://mangopay.com/docs/please-ignore
              CardId: '{{CARD_CHALLENGE_FLOW_ID}}'
              StatementDescriptor: Mangopay
              Billing:
                FirstName: '{{$randomFirstName}}'
                LastName: '{{$randomLastName}}'
                Address:
                  AddressLine1: '{{$randomStreetAddress}}'
                  AddressLine2: '{{$randomStreetName}}'
                  City: Paris
                  Region: Ile-de-France
                  PostalCode: '75001'
                  Country: FR
              Shipping:
                FirstName: '{{$randomFirstName}}'
                LastName: '{{$randomLastName}}'
                Address:
                  AddressLine1: '{{$randomStreetAddress}}'
                  AddressLine2: '{{$randomStreetName}}'
                  City: Paris
                  Region: Ile-de-France
                  PostalCode: '75001'
                  Country: FR
              Tag: Created using Mangopay API Postman Collection
              Culture: '{{CULTURE}}'
              IpAddress: '{{$randomIPV6}}'
              BrowserInfo:
                AcceptHeader: text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8
                JavaEnabled: true
                Language: FR-FR
                ColorDepth: 4
                ScreenHeight: 1800
                ScreenWidth: 400
                TimeZoneOffset: 60
                UserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
                JavascriptEnabled: true
  /payins/{payinId}:
    get:
      tags:
      - Payment methods
      summary: View a PayIn
      operationId: get_payins_payinId
      parameters:
      - name: payinId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/direct-card-payins#view-payin](https://mangopay.com/docs/endpoints/direct-card-payins#view-payin)'
  /recurringpayinregistrations:
    post:
      tags:
      - Payment methods
      summary: Create a Recurring PayIn Registration
      operationId: post_recurringpayinregistrations
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/recurring-card-payins#create-recurring-payin-registration](https://mangopay.com/docs/endpoints/recurring-card-payins#create-recurring-payin-registration)'
  /recurringpayinregistrations/{recurringpayinregistrationid}:
    put:
      tags:
      - Payment methods
      summary: Update a Recurring PayIn Registration
      operationId: put_recurringpayinregistrations_recurringpayinregistrationid
      parameters:
      - name: recurringpayinregistrationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/recurring-card-payins#update-recurring-payin-registration](https://mangopay.com/docs/endpoints/recurring-card-payins#update-recurring-payin-registration)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              CardId: '{{CARD_CHALLENGE_FLOW_ID}}'
              Status: ENDED
              Billing:
                FirstName: '{{$randomFirstName}}'
                LastName: '{{$randomLastName}}'
                Address:
                  AddressLine1: '{{$randomStreetAddress}}'
                  AddressLine2: '{{$randomStreetName}}'
                  City: Paris
                  Region: Ile-de-France
                  PostalCode: '75001'
                  Country: FR
              Shipping:
                FirstName: '{{$randomFirstName}}'
                LastName: '{{$randomLastName}}'
                Address:
                  AddressLine1: '{{$randomStreetAddress}}'
                  AddressLine2: '{{$randomStreetName}}'
                  City: Paris
                  Region: Ile-de-France
                  PostalCode: '75001'
                  Country: FR
    get:
      tags:
      - Payment methods
      summary: View a Recurring PayIn Registration
      operationId: get_recurringpayinregistrations_recurringpayinregistrationid
      parameters:
      - name: recurringpayinregistrationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/recurring-card-payins#view-recurring-payin-registration](https://mangopay.com/docs/endpoints/recurring-card-payins#view-recurring-payin-registration)'
  /payins/recurring/card/direct:
    post:
      tags:
      - Payment methods
      summary: Create a Recurring PayIn CIT
      operationId: post_payins_recurring_card_direct
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/recurring-card-payins#create-recurring-payin-cit](https://mangopay.com/docs/endpoints/recurring-card-payins#create-recurring-payin-cit)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              RecurringPayinRegistrationId: '{{RECURRING_PAYIN_REGISTRATION_ID}}'
              IpAddress: '{{$randomIPV6}}'
              BrowserInfo:
                AcceptHeader: text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8
                JavaEnabled: true
                Language: FR-FR
                ColorDepth: 4
                ScreenHeight: 1800
                ScreenWidth: 400
                TimeZoneOffset: 60
                UserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
                JavascriptEnabled: true
              SecureModeReturnURL: https://mangopay.com/docs/please-ignore
              StatementDescriptor: POSTMAN
              Tag: Created using Mangopay API Postman Collection
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 10000
              Fees:
                Currency: '{{CURRENCY}}'
                Amount: 1000
  /preauthorizations/card/direct:
    post:
      tags:
      - Payment methods
      summary: Create a Preauthorization
      operationId: post_preauthorizations_card_direct
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#create-preauthorization](https://mangopay.com/docs/endpoints/preauthorizations#create-preauthorization)'
  /preauthorizations/{preauthorizationid}:
    put:
      tags:
      - Payment methods
      summary: Cancel or validate a Preauthorization
      operationId: put_preauthorizations_preauthorizationid
      parameters:
      - name: preauthorizationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#cancel-validate-preauthorization](https://mangopay.com/docs/endpoints/preauthorizations#cancel-validate-preauthorization)'
    get:
      tags:
      - Payment methods
      summary: View a Preauthorization
      operationId: get_preauthorizations_preauthorizationid
      parameters:
      - name: preauthorizationid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#view-preauthorization](https://mangopay.com/docs/endpoints/preauthorizations#view-preauthorization)'
  /cards/{cardchallengeflowid}/preauthorizations:
    get:
      tags:
      - Payment methods
      summary: List Preauthorizations for a Card
      operationId: get_cards_cardchallengeflowid_preauthorizations
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#list-preauthorizations-card](https://mangopay.com/docs/endpoints/preauthorizations#list-preauthorizations-card)'
  /users/{userId}/preauthorizations:
    get:
      tags:
      - Payment methods
      summary: List Preauthorizations for a User
      operationId: get_users_userId_preauthorizations
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#list-preauthorizations-user](https://mangopay.com/docs/endpoints/preauthorizations#list-preauthorizations-user)'
  /payins/preauthorized/direct:
    post:
      tags:
      - Payment methods
      summary: Create a Preauthorized PayIn
      operationId: post_payins_preauthorized_direct
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#create-preauthorized-payin](https://mangopay.com/docs/endpoints/preauthorizations#create-preauthorized-payin)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              CreditedWalletId: '{{USER_NATURAL_PAYER_WALLET_ID}}'
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 10000
              Fees:
                Currency: '{{CURRENCY}}'
                Amount: 1000
              PreauthorizationId: '{{PREAUTHORIZATION_ID}}'
  /deposit-preauthorizations/card/direct:
    post:
      tags:
      - Payment methods
      summary: Create a Deposit Preauthorization
      operationId: post_deposit_preauthorizations_card_direct
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#create-deposit-preauthorization](https://mangopay.com/docs/endpoints/preauthorizations#create-deposit-preauthorization)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              AuthorId: '{{USER_NATURAL_PAYER}}'
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 20000
              CardId: '{{CARD_CHALLENGE_FLOW_ID}}'
              SecureModeReturnURL: https://mangopay.com/docs/please-ignore
              Culture: '{{CULTURE}}'
              IpAddress: '{{$randomIPV6}}'
              BrowserInfo:
                AcceptHeader: text/html, application/xhtml+xml, application/xml;q=0.9, /;q=0.8
                JavaEnabled: true
                Language: FR-FR
                ColorDepth: 4
                ScreenHeight: 1800
                ScreenWidth: 400
                TimeZoneOffset: 60
                UserAgent: Mozilla/5.0 (iPhone; CPU iPhone OS 13_6_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148
                JavascriptEnabled: true
              Tag: Created using the Mangopay API Postman collection
  /deposit-preauthorizations/{depositid}:
    put:
      tags:
      - Payment methods
      summary: Cancel a Deposit Preauthorization
      operationId: put_deposit_preauthorizations_depositid
      parameters:
      - name: depositid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#cancel-deposit-preauthorization-request-no-show](https://mangopay.com/docs/endpoints/preauthorizations#cancel-deposit-preauthorization-request-no-show)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              PaymentStatus: CANCELED
    get:
      tags:
      - Payment methods
      summary: View a Deposit Preauthorization
      operationId: get_deposit_preauthorizations_depositid
      parameters:
      - name: depositid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#view-deposit-preauthorization](https://mangopay.com/docs/endpoints/preauthorizations#view-deposit-preauthorization)'
  /cards/{cardchallengeflowid}/deposit-preauthorizations:
    get:
      tags:
      - Payment methods
      summary: List Deposit Preauthorizations for a Card
      operationId: get_cards_cardchallengeflowid_deposit_preauthorizations
      parameters:
      - name: cardchallengeflowid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#list-deposit-preathorization-card](https://mangopay.com/docs/endpoints/preauthorizations#list-deposit-preathorization-card)'
  /users/{userId}/deposit-preauthorizations:
    get:
      tags:
      - Payment methods
      summary: List Deposit Preauthorizations for a User
      operationId: get_users_userId_deposit_preauthorizations
      parameters:
      - name: userId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#list-deposit-preathorization-user](https://mangopay.com/docs/endpoints/preauthorizations#list-deposit-preathorization-user)'
  /payins/deposit-preauthorized/direct/full-capture:
    post:
      tags:
      - Payment methods
      summary: Create a Deposit Preauthorized PayIn
      operationId: post_payins_deposit_preauthorized_direct_full_capture
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/preauthorizations#create-deposit-preauthorized-payin-without-complement](https://mangopay.com/docs/endpoints/preauthorizations#create-deposit-preauthorized-payin-without-complement)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              AuthorId: '{{USER_NATURAL_PAYER}}'
              CreditedWalletId: '{{USER_NATURAL_PAYER_WALLET_ID}}'
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 10000
              Fees:
                Currency: '{{CURRENCY}}'
                Amount: 1000
              DepositId: '{{DEPOSIT_ID}}'
              Tag: Created using Mangopay API Postman Collection
  /payins/card/web:
    post:
      tags:
      - Payment methods
      summary: Create a Web Card PayIn
      operationId: post_payins_card_web
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/web-card-payins#create-web-card-payin](https://mangopay.com/docs/endpoints/web-card-payins#create-web-card-payin)'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
            example:
              Tag: Created using Mangopay API Postman Collection
              AuthorId: '{{USER_NATURAL_PAYER}}'
              DebitedFunds:
                Currency: '{{CURRENCY}}'
                Amount: 12000
              Fees:
                Currency: '{{CURRENCY}}'
                Amount: 1000
              ReturnURL: https://mangopay.com/docs/please-ignore
              CardType: CB_VISA_MASTERCARD
              CreditedWalletId: '{{USER_NATURAL_PAYER_WALLET_ID}}'
              Culture: '{{CULTURE}}'
  /payins/card/web/{webpayinid}/extended:
    get:
      tags:
      - Payment methods
      summary: View card details for a Web Card PayIn
      operationId: get_payins_card_web_webpayinid_extended
      parameters:
      - name: webpayinid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[https://mangopay.com/docs/endpoints/web-card-payins#view-card-details-web-card-payin](https://mangopay.com/docs/endpoints/web-card-payins#view-card-details-web-card-payin)'
  /payment-methods/metadata:
    post:
      tags:
      - Payment methods
      summary: Look up metadata for a payment method
      operationId: post_payment_methods_metadata
      parameters: []
      responses:
        '200':
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      description: '[ht

# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mangopay/refs/heads/main/openapi/mangopay-payment-methods-api-openapi.yml