> ## Documentation Index > Fetch the complete documentation index at: https://docs.birrpay.io/llms.txt > Use this file to discover all available pages before exploring further. # Payment Method - Create Intent > Creates a payment method for customer with billing information and other metadata. ## OpenAPI ````yaml post /v2/payment-methods/create-intent openapi: 3.0.3 info: title: BirrPay - API Documentation description: > ## Get started BirrPay provides a collection of APIs that enable you to process and manage payments. Our APIs accept and return JSON in the HTTP body, and return standard HTTP response codes. You can consume the APIs directly using your favorite HTTP/REST library. We have a testing environment referred to "sandbox", which you can setup to test API calls without affecting production data. Currently, our sandbox environment is live while our production environment is under development and will be available soon. You can sign up on our Dashboard to get API keys to access BirrPay API. ### Environment Use the following base URLs when making requests to the APIs: | Environment | Base URL | |---------------|------------------------------------| | Sandbox | | | Production | | ## Authentication When you sign up on our [dashboard](https://app.birrpay.io) and create a merchant account, you are given a secret key (also referred as api-key) and a publishable key. You may authenticate all API requests with BirrPay server by providing the appropriate key in the request Authorization header. | Key | Description | |-----------------|-----------------------------------------------------------------------------------------------| | api-key | Private key. Used to authenticate all API requests from your merchant server | | publishable key | Unique identifier for your account. Used to authenticate API requests from your app's client | Never share your secret api keys. Keep them guarded and secure. contact: name: BirrPay Support url: https://birrpay.io email: support@birrpay.io license: name: Apache-2.0 version: 0.1.0 servers: - url: https://sandbox.birrpay.io description: Sandbox Environment security: [] tags: - name: Merchant Account description: Create and manage merchant accounts - name: Profile description: Create and manage profiles - name: Merchant Connector Account description: Create and manage merchant connector accounts - name: Payments description: Create and manage one-time payments, recurring payments and mandates - name: Refunds description: Create and manage refunds for successful payments - name: Mandates description: Manage mandates - name: Customers description: Create and manage customers - name: Payment Methods description: Create and manage payment methods of customers - name: Disputes description: Manage disputes - name: API Key description: Create and manage API Keys - name: Payouts description: Create and manage payouts - name: payment link description: Create payment link - name: Routing description: Create and manage routing configurations - name: Event description: Manage events paths: /v2/payment-methods/create-intent: post: tags: - Payment Methods summary: Payment Method - Create Intent description: >- Creates a payment method for customer with billing information and other metadata. operationId: Create Payment Method Intent requestBody: content: application/json: schema: $ref: '#/components/schemas/PaymentMethodIntentCreate' required: true responses: '200': description: Payment Method Intent Created content: application/json: schema: $ref: '#/components/schemas/PaymentMethodResponse' '400': description: Invalid Data security: - api_key: [] components: schemas: PaymentMethodIntentCreate: type: object required: - customer_id properties: metadata: type: object description: >- You can specify up to 50 keys, with key names up to 40 characters long and values up to 500 characters long. Metadata is useful for storing additional, structured information on an object. nullable: true billing: allOf: - $ref: '#/components/schemas/Address' nullable: true customer_id: type: string description: The unique identifier of the customer. example: 12345_cus_01926c58bc6e77c09e809964e72af8c8 maxLength: 64 minLength: 32 additionalProperties: false PaymentMethodResponse: type: object required: - id - merchant_id - customer_id - payment_method_type - network_transaction_id properties: id: type: string description: The unique identifier of the Payment method example: 12345_pm_01926c58bc6e77c09e809964e72af8c8 merchant_id: type: string description: Unique identifier for a merchant example: merchant_1671528864 customer_id: type: string description: The unique identifier of the customer. example: 12345_cus_01926c58bc6e77c09e809964e72af8c8 maxLength: 64 minLength: 32 payment_method_type: $ref: '#/components/schemas/PaymentMethod' payment_method_subtype: allOf: - $ref: '#/components/schemas/PaymentMethodType' nullable: true recurring_enabled: type: boolean description: >- Indicates whether the payment method supports recurring payments. Optional. example: true nullable: true created: type: string format: date-time description: >- A timestamp (ISO 8601 code) that determines when the payment method was created example: '2023-01-18T11:04:09.922Z' nullable: true last_used_at: type: string format: date-time description: >- A timestamp (ISO 8601 code) that determines when the payment method was last used example: '2024-02-24T11:04:09.922Z' nullable: true payment_method_data: allOf: - $ref: '#/components/schemas/PaymentMethodResponseData' nullable: true connector_tokens: type: array items: $ref: '#/components/schemas/ConnectorTokenDetails' description: The connector token details if available nullable: true network_token: allOf: - $ref: '#/components/schemas/NetworkTokenResponse' nullable: true storage_type: allOf: - $ref: '#/components/schemas/StorageType' nullable: true card_cvc_token_storage: allOf: - $ref: '#/components/schemas/CardCVCTokenStorageDetails' nullable: true network_transaction_id: type: string description: >- The network transaction ID provided by the card network during a Customer Initiated Transaction (CIT) when `setup_future_usage` is set to `off_session`. Address: type: object properties: address: allOf: - $ref: '#/components/schemas/AddressDetails' nullable: true phone: allOf: - $ref: '#/components/schemas/PhoneDetails' nullable: true email: type: string nullable: true PaymentMethod: type: string description: 'Indicates the type of payment method. Eg: ''card'', ''wallet'', etc.' enum: - card - card_redirect - pay_later - wallet - bank_redirect - bank_transfer - crypto - bank_debit - reward - real_time_payment - upi - voucher - gift_card - open_banking - mobile_payment - network_token PaymentMethodType: type: string description: >- Indicates the sub type of payment method. Eg: 'google_pay' & 'apple_pay' for wallets. enum: - ach - affirm - afterpay_clearpay - alfamart - ali_pay - ali_pay_hk - alma - amazon_pay - paysera - apple_pay - atome - bacs - bancontact_card - becs - benefit - bizum - blik - bluecode - boleto - bca_bank_transfer - bni_va - breadpay - bri_va - bhn_card_network - card_redirect - cimb_va - classic - credit - crypto_currency - cashapp - dana - danamon_va - debit - duit_now - efecty - eft - eps - flexiti - fps - evoucher - giropay - givex - google_pay - go_pay - gcash - ideal - interac - indomaret - klarna - kakao_pay - local_bank_redirect - mandiri_va - knet - mb_way - mobile_pay - momo - momo_atm - multibanco - online_banking_thailand - online_banking_czech_republic - online_banking_finland - online_banking_fpx - online_banking_poland - online_banking_slovakia - oxxo - pago_efectivo - permata_bank_transfer - open_banking_uk - pay_bright - payjustnow - paypal - paze - pix - pay_safe_card - przelewy24 - prompt_pay - pse - qris - red_compra - red_pagos - samsung_pay - sepa - sepa_bank_transfer - sepa_guarenteed_debit - skrill - sofort - swish - touch_n_go - trustly - twint - upi_collect - upi_intent - upi_qr - vipps - viet_qr - venmo - walley - we_chat_pay - seven_eleven - lawson - mini_stop - family_mart - seicomart - pay_easy - local_bank_transfer - mifinity - open_banking_pis - direct_carrier_billing - instant_bank_transfer - instant_bank_transfer_finland - instant_bank_transfer_poland - revolut_pay - indonesian_bank_transfer - open_banking - network_token PaymentMethodResponseData: oneOf: - type: object required: - card properties: card: $ref: '#/components/schemas/CardDetailFromLocker' ConnectorTokenDetails: type: object description: >- Token information that can be used to initiate transactions by the merchant. required: - token properties: token: type: string description: >- A token that can be used to make payments directly with the connector. example: pm_9UhMqBMEOooRIvJFFdeW connector_token_request_reference_id: type: string description: The reference id sent to the connector when creating the token nullable: true NetworkTokenResponse: type: object required: - payment_method_data properties: payment_method_data: $ref: '#/components/schemas/NetworkTokenDetailsPaymentMethod' StorageType: type: string enum: - volatile - persistent CardCVCTokenStorageDetails: type: object required: - is_stored properties: is_stored: type: boolean description: Indicates whether the card cvc is stored or not example: true expires_at: type: string format: date-time description: >- A timestamp (ISO 8601 code) that determines expiry for stored card cvc token example: '2024-02-24T11:04:09.922Z' nullable: true AddressDetails: type: object description: Address details properties: city: type: string description: The city, district, suburb, town, or village of the address. example: New York nullable: true maxLength: 50 country: allOf: - $ref: '#/components/schemas/CountryAlpha2' nullable: true line1: type: string description: The first line of the street address or P.O. Box. example: 123, King Street nullable: true maxLength: 200 line2: type: string description: >- The second line of the street address or P.O. Box (e.g., apartment, suite, unit, or building). example: Powelson Avenue nullable: true maxLength: 50 line3: type: string description: The third line of the street address, if applicable. example: Bridgewater nullable: true maxLength: 50 zip: type: string description: The zip/postal code for the address example: '08807' nullable: true maxLength: 50 state: type: string description: The address state example: New York nullable: true first_name: type: string description: The first name for the address example: John nullable: true maxLength: 255 last_name: type: string description: The last name for the address example: Doe nullable: true maxLength: 255 origin_zip: type: string description: The zip/postal code of the origin example: '08807' nullable: true maxLength: 50 PhoneDetails: type: object properties: number: type: string description: The contact number example: '9123456789' nullable: true country_code: type: string description: The country code attached to the number example: '+1' nullable: true CardDetailFromLocker: type: object required: - saved_to_locker properties: issuer_country: allOf: - $ref: '#/components/schemas/CountryAlpha2' nullable: true last4_digits: type: string example: '4242' nullable: true expiry_month: type: string example: '10' nullable: true expiry_year: type: string example: '25' nullable: true card_holder_name: type: string example: John Doe nullable: true card_fingerprint: type: string example: fingerprint_12345 nullable: true nick_name: type: string example: Card nullable: true card_network: allOf: - $ref: '#/components/schemas/CardNetwork' nullable: true card_isin: type: string example: '4567890' nullable: true card_issuer: type: string example: Issuer Bank nullable: true card_type: type: string example: Credit nullable: true saved_to_locker: type: boolean example: true NetworkTokenDetailsPaymentMethod: type: object properties: last4_digits: type: string example: '4242' nullable: true issuer_country: allOf: - $ref: '#/components/schemas/CountryAlpha2' nullable: true network_token_expiry_month: type: string example: '05' nullable: true network_token_expiry_year: type: string example: '27' nullable: true nick_name: type: string example: Card nullable: true card_holder_name: type: string example: John Doe nullable: true card_isin: type: string example: '16712672' nullable: true card_issuer: type: string example: Bank of America nullable: true card_network: allOf: - $ref: '#/components/schemas/CardNetwork' nullable: true card_type: type: string example: Credit nullable: true saved_to_locker: type: boolean CountryAlpha2: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BQ - BA - BW - BV - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CW - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MK - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SZ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW - US CardNetwork: type: string description: Indicates the card network. enum: - Visa - Mastercard - AmericanExpress - JCB - DinersClub - Discover - CartesBancaires - UnionPay - Interac - RuPay - Maestro - Star - Pulse - Accel - Nyce securitySchemes: api_key: type: apiKey in: header name: Authorization description: >- Format: `api-key=` Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application. ````