Synswi
  1. Payment instruments
Synswi
  • Guides
    • Getting Started With the API
  • API Reference
    • Accounts
      • Onboarding forms
        • Create a Onboarding Form
      • Get account setting
      • Update account setting
      • Get profile
      • Create new profile
      • Register webhook
    • Devices
      • Get Devices
    • Dispute
      • Get disputes
    • Invoice
      • Get invoice by id
      • Get invoices
      • Create an invoice
      • Pay an invoice
      • Send Invoice
      • Update an invoice
    • Payment instruments
      • Create a payment instrument
      • Get payment instruments
        GET
      • Get a payment instrument by id
        GET
      • Create a Payment Instrument
        POST
    • Transactions
      • Get a transaction by id
      • Get transactions
      • Create a transaction
    • Settlements
      • get settlements
      • get settlement entries
    • Identity
      • Register an user
      • Validate Token
      • Create an api key
      • List api keys
      • Get Users
    • Programs
      • Accounts
    • Permission
      • Verify user permissions
      • Get Account Users
  1. Payment instruments

Create a Payment Instrument

Developing
POST
https://api-dev.synswi.com/payment-instruments

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/jsonRequired

Example
{
    "accountId": "32",
    "token": "in deserunt mollit",
    "card": {
        "cardNumber": "Hatchback",
        "expYear": "2026",
        "expMonth": "January",
        "cvv": "199"
    },
    "owner": {
        "name": {
            "fullName": "Earnest Pfannerstill"
        }
    },
    "billingAddress": {
        "addressLine1": "ad",
        "addressLine2": "in",
        "city": "Alexandreton",
        "state": "North Dakota",
        "zipcode": "25630",
        "country": "Panama"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-dev.synswi.com/payment-instruments' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountId": "32",
    "token": "in deserunt mollit",
    "card": {
        "cardNumber": "Hatchback",
        "expYear": "2026",
        "expMonth": "January",
        "cvv": "199"
    },
    "owner": {
        "name": {
            "fullName": "Earnest Pfannerstill"
        }
    },
    "billingAddress": {
        "addressLine1": "ad",
        "addressLine2": "in",
        "city": "Alexandreton",
        "state": "North Dakota",
        "zipcode": "25630",
        "country": "Panama"
    }
}'

Responses

🟢200Success
application/json
Body

Example
{}
Previous
Get a payment instrument by id
Next
Get a transaction by id
Built with