Mangopay

Mangopay Payment methods API

The Payment methods API from Mangopay — 61 operation(s) for payment methods.

GitHub OpenAPI

Operations 67

POST /cardregistrations Create a Card Registration #
POST {cardregistrationurl} Tokenize the Card (Challenge Flow Card) #
PUT /cardregistrations/{cardregistrationid} Update a Card Registration #
GET /cardregistrations/{cardregistrationid} View a Card Registration #
PUT /cards/{cardchallengeflowid} Deactivate a card #
GET /cards/{cardchallengeflowid} View a Card #
GET /users/{userId}/cards List Cards for a User #
GET /cards/fingerprints/{cardfingerprint} List Cards for a Fingerprint #
GET /cards/fingerprints/{cardfingerprint}/transactions List Transactions for a Card Fingerprint #
POST /cards/{cardchallengeflowid}/validation Create a Card Validation #
GET /cards/{cardchallengeflowid}/validation/{cardvalidationid} View a Card Validation #
POST /payins/card/direct Create a Card Direct PayIn #
GET /payins/{payinId} View a PayIn #
POST /recurringpayinregistrations Create a Recurring PayIn Registration #
PUT /recurringpayinregistrations/{recurringpayinregistrationid} Update a Recurring PayIn Registration #
GET /recurringpayinregistrations/{recurringpayinregistrationid} View a Recurring PayIn Registration #
POST /payins/recurring/card/direct Create a Recurring PayIn CIT #
POST /preauthorizations/card/direct Create a Preauthorization #
PUT /preauthorizations/{preauthorizationid} Cancel or validate a Preauthorization #
GET /preauthorizations/{preauthorizationid} View a Preauthorization #
GET /cards/{cardchallengeflowid}/preauthorizations List Preauthorizations for a Card #
GET /users/{userId}/preauthorizations List Preauthorizations for a User #
POST /payins/preauthorized/direct Create a Preauthorized PayIn #
POST /deposit-preauthorizations/card/direct Create a Deposit Preauthorization #
PUT /deposit-preauthorizations/{depositid} Cancel a Deposit Preauthorization #
GET /deposit-preauthorizations/{depositid} View a Deposit Preauthorization #
GET /cards/{cardchallengeflowid}/deposit-preauthorizations List Deposit Preauthorizations for a Card #
GET /users/{userId}/deposit-preauthorizations List Deposit Preauthorizations for a User #
POST /payins/deposit-preauthorized/direct/full-capture Create a Deposit Preauthorized PayIn #
POST /payins/card/web Create a Web Card PayIn #
GET /payins/card/web/{webpayinid}/extended View card details for a Web Card PayIn #
POST /payment-methods/metadata Look up metadata for a payment method #
GET /virtual-accounts/availability View Virtual Account availabilities #
POST /wallets/{walletId}/virtual-accounts Create Virtual Account #
PUT /wallets/{usernaturalpayerwalletid}/virtual-accounts/{virtualaccountid} Deactivate a Virtual Account #
GET /wallets/{walletId}/virtual-accounts/{virtualaccountid} View a Virtual Account #
GET /wallets/{usernaturalpayerwalletid}/virtual-accounts List Virtual Accounts for a Wallet #
POST /wallets/{userlegalownerwalletid}/bankingaliases/iban Create an IBAN Banking Alias #
PUT /bankingaliases/{bankingaliasid} Deactivate a Banking Alias #
GET /bankingaliases/{bankingaliasid} View a Banking Alias #
GET /wallets/{userlegalownerwalletid}/bankingaliases View a Banking Alias for a Wallet #
POST /payins/bankwire/direct Create a Direct Bank Wire PayIn #
GET /payment-methods/openbanking/metadata/supported-banks View supported banks for Pay by Bank #
POST /payins/payment-methods/openbanking Create a Pay by Bank PayIn #
POST /mandates/directdebit/web Create a Mandate #
GET /mandates/{mandateId} View a Mandate #
PUT /mandates/{mandateId}/cancel Cancel a Mandate #
GET /mandates List all Mandates #
GET /users/{legaluserbankaccountid}/mandates List Mandates for a Bank Account #
GET /users/{userId}/mandates List Mandates for a User #
POST /payins/directdebit/direct Create a Direct Debit PayIn (Legal Payer User) #
POST /payins/payment-methods/bancontact Create a Bancontact PayIn #
POST /payins/payment-methods/bizum Create a Bizum PayIn #
POST /payins/payment-methods/blik Create a BLIK PayIn #
POST /payins/payment-methods/ideal Create an iDEAL PayIn #
POST /payins/payment-methods/klarna Create a Klarna PayIn #
POST /payins/payment-methods/mbway Create an MB WAY PayIn #
POST /payins/payment-methods/multibanco Create a Multibanco PayIn #
POST /payins/payment-methods/payconiq Create a Payconiq PayIn #
POST /payins/payment-methods/paypal/data-collection Submit risk data for PayPal PayIn #
GET /payins/payment-methods/paypal/data-collection/{datacollectionid} View risk data for PayPal PayIn #
POST /payins/payment-methods/paypal/recurring Create a Recurring PayPal PayIn (CIT) #
POST /payins/payment-methods/paypal Create a PayPal PayIn #
PUT /payins/{paypalpayinid}/trackings Add tracking information to a PayPal PayIn #
POST /payins/payment-methods/satispay Create a Satispay PayIn #
POST {envurl}/v2.1/{clientId}/payins/payment-methods/swish Create a Swish PayIn #
POST /payins/payment-methods/twint Create a Twint PayIn #

Documentation

📖
Documentation
https://docs.mangopay.com
📖
Authentication
https://docs.mangopay.com/api-reference/overview/authentication
📖
RateLimits
https://docs.mangopay.com/api-reference/overview/rate-limiting
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/mangopay/refs/heads/main/rate-limits/rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mangopay/refs/heads/main/openapi/mangopay-payment-methods-api-openapi.yml

Other Resources

🔗
Webhooks
https://docs.mangopay.com/webhooks
🔗
ErrorCodes
https://docs.mangopay.com/errors
🔗
Postman
https://docs.mangopay.com/postman
🔗
Sandbox
https://api.sandbox.mangopay.com
🔗
ChangeLog
https://docs.mangopay.com/release-notes
🔗
SDKs
https://docs.mangopay.com/sdks
🔗
GitHubOrganization
https://github.com/Mangopay
🔗
SDKs
https://www.npmjs.com/package/mangopay4-nodejs-sdk
🔗
SDKs
https://github.com/Mangopay/mangopay4-php-sdk
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/mangopay/refs/heads/main/plans/plans.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/mangopay/refs/heads/main/finops/finops.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mangopay-payment-methods-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mangopay-payment-methods-api-openapi.yml Raw ↑ 
openapi: 3.2.0
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