Skip to content
FFastPay Docs

Customers

Create a customer

POST/api/v1/customers
AuthorizationBearer sk_test_… or sk_live_…

Headers#

  • Idempotency-KeystringRequired

    Client-generated key that makes the request safe to retry. Replaying the key with an identical payload returns the original response; replaying it with a different payload is rejected. Up to 255 characters.

Body parameters#

  • country_codestringOptional

    Exactly 2 characters.

  • emailstringOptional

    Up to 254 characters.

  • first_namestringOptional

    Up to 100 characters.

  • last_namestringOptional

    Up to 100 characters.

  • metadataobjectOptional
  • phonestringOptional

    Up to 20 characters.

Responses#

  • 201Created
  • 400The request could not be read.
  • 401The secret key is missing, invalid or revoked.
  • 403The key is not allowed to do this, or the request came from an address that is not on its allowlist.
  • 409The request clashes with the current state, such as a reference reused with different details.
  • 422A field is missing or not valid.