---
updatedAt: 2025-11-06T17:21:19.000Z
agentTools:
  projectIndex: https://docs.ecartpay.com/llms.txt
---

# Create and Store a Card

Add a card to your account which you will be able to use to receive money or make payments.

> 📘 Visit our Documentation to learn more about [Cards](https://docs.ecartpay.com/docs/cards#/).

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Payments API, the best solution in LATAM for businesses | Ecart Pay Developers",
    "description": "**Ecart Pay** is a payment solution which unifies multiple payment processors into a single, easy to use, platform or API.\n\n**Why should I use Ecart Pay?**\n\n1.  Increase acceptance rate by using more than one payment processor.\n2.  Manage all your payments with a unified admin tool.\n3.  Create partial and complete refunds easily.\n4.  Issue invoices which comply with government requirements in every country.\n5.  Send payouts to bank accounts around the world.\n    \n\nIf your business accepts payments online, we are a right fit for you.\n\n**What makes Ecart Pay unique?**\n\nWe offer a 360 solution for [payments](https://docs.ecartpay.com/#16e69a32-46ca-4075-8c7d-b67e6df258fd), [payouts](https://docs.ecartpay.com/#db2cfd82-eca8-4531-a965-31e3da4a791f) and withdrawals with government compliance.\n\nWith Ecart Pay you can receive payments not only by credit and debit cards. Your customers will be able to pay in the supermarket, convenience stores, bank transfers and other local payment solutions that vary by country.\n\n**Which countries and currencies does Ecart Pay serve?**\n\n| **Currency** | **Country** |\n| --- | --- |\n| USD | USA |\n| INR | India |\n| MXN | Mexico |\n| BRL | Brasil |\n| COP | Colombia |\n| ARG | Argentina |\n| GTQ | Guatemala |\n| CLP | Chile |\n| PEN | Peru |\n| CAD | Canada |\n| EUR | Spain |\n| AUS | Australia |\n\n**And more countries coming soon!**",
    "version": "1.0.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://sandbox.ecartpay.com"
    }
  ],
  "paths": {
    "/api/cards": {
      "post": {
        "tags": [
          "Cards"
        ],
        "summary": "Create and Store a Card",
        "description": "Add a card to your account which you will be able to use to receive money or make payments.",
        "operationId": "createCard",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "exp_month": {
                    "type": "string",
                    "example": "01"
                  },
                  "exp_year": {
                    "type": "string",
                    "example": "2012"
                  },
                  "name": {
                    "type": "string",
                    "example": "Ecart Pay"
                  },
                  "number": {
                    "type": "string",
                    "example": "4242-4242-4242-4142"
                  }
                }
              },
              "examples": {
                "Create card": {
                  "value": {
                    "exp_month": "01",
                    "exp_year": "2012",
                    "name": "Ecart Pay",
                    "number": "4242-4242-4242-4142"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Create Card",
            "headers": {
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string",
                  "example": "*"
                }
              },
              "CF-Cache-Status": {
                "schema": {
                  "type": "string",
                  "example": "DYNAMIC"
                }
              },
              "CF-RAY": {
                "schema": {
                  "type": "string",
                  "example": "6fad602c99039ed4-DFW"
                }
              },
              "Connection": {
                "schema": {
                  "type": "string",
                  "example": "keep-alive"
                }
              },
              "Content-Encoding": {
                "schema": {
                  "type": "string",
                  "example": "br"
                }
              },
              "Content-Language": {
                "schema": {
                  "type": "string",
                  "example": "api"
                }
              },
              "Date": {
                "schema": {
                  "type": "string",
                  "example": "Tue, 12 Apr 2022 16:35:32 GMT"
                }
              },
              "Etag": {
                "schema": {
                  "type": "string",
                  "example": "W/\"130-njClHIqijp+1+Q4Q89aabFDUVcw\""
                }
              },
              "Expect-CT": {
                "schema": {
                  "type": "string",
                  "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\""
                }
              },
              "NEL": {
                "schema": {
                  "type": "string",
                  "example": "{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"
                }
              },
              "Report-To": {
                "schema": {
                  "type": "string",
                  "example": "{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=9DvA3HnAw6MDckhfBLh1Dox7qaHx6itIYo9z0d4x%2FDnyXwYkjYctrjD5AbUWmz%2BaDPMzh6hyqs8YtlagF%2BlcSuMva3YEYtZrmn1VO4fLKo6%2Ft0%2BioTpuyic9CVJu6NgPzCJ%2Bz%2FrZ7Q%3D%3D\"}],\"group\":\"cf-nel\",\"max_age\":604800}"
                }
              },
              "Server": {
                "schema": {
                  "type": "string",
                  "example": "cloudflare"
                }
              },
              "Strict-Transport-Security": {
                "schema": {
                  "type": "string",
                  "example": "max-age=2592000; includeSubDomains"
                }
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string",
                  "example": "chunked"
                }
              },
              "Via": {
                "schema": {
                  "type": "string",
                  "example": "1.1 vegur"
                }
              },
              "X-Content-Type-Options": {
                "schema": {
                  "type": "string",
                  "example": "nosniff"
                }
              },
              "X-Powered-By": {
                "schema": {
                  "type": "string",
                  "example": "Express"
                }
              },
              "alt-svc": {
                "schema": {
                  "type": "string",
                  "example": "h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "account_id": {
                      "type": "string",
                      "example": "62559ba8085afe001606a916"
                    },
                    "brand": {
                      "type": "string",
                      "example": "visa"
                    },
                    "created_at": {
                      "type": "string",
                      "example": "2022-04-12T16:35:32.139Z"
                    },
                    "exp_month": {
                      "type": "string",
                      "example": "01"
                    },
                    "exp_year": {
                      "type": "string",
                      "example": "2012"
                    },
                    "id": {
                      "type": "string",
                      "example": "6255aa54c2c8a9f87135daad"
                    },
                    "last": {
                      "type": "string",
                      "example": "4142"
                    },
                    "name": {
                      "type": "string",
                      "example": "Ecart Pay"
                    },
                    "number": {
                      "type": "string",
                      "example": "U2FsdGVkX1/8Y7XiovRkPZ3vZ0VYqT/AWibdiAN+A1VGAXcQrHbX9A=="
                    },
                    "updated_at": {
                      "type": "string",
                      "example": "2022-04-12T16:35:32.139Z"
                    }
                  }
                },
                "examples": {
                  "Create Card": {
                    "value": {
                      "account_id": "62559ba8085afe001606a916",
                      "brand": "visa",
                      "created_at": "2022-04-12T16:35:32.139Z",
                      "exp_month": "01",
                      "exp_year": "2012",
                      "id": "6255aa54c2c8a9f87135daad",
                      "last": "4142",
                      "name": "Ecart Pay",
                      "number": "U2FsdGVkX1/8Y7XiovRkPZ3vZ0VYqT/AWibdiAN+A1VGAXcQrHbX9A==",
                      "updated_at": "2022-04-12T16:35:32.139Z"
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [],
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "tags": [
    {
      "name": "Cards",
      "description": "**Ecart Pay** securely stores cards information. Offering a fully secure PCI compliance environment. Customers are able to store credit card information to either receive money or pay at checkout.\n\nOur **Ecart Pay** automated checkout flow. Allows active customer to make secure payments without needing to add your card information every time.\n\nFor card security, you are not able to retrieve or create the verifying digits via the API."
    }
  ],
  "x-readme": {}
}
```