---
title: "Create a purchase, with fraud screening"
method: POST
path: "/purchases/ ​​​​"
---

# Create a purchase, with fraud screening

`POST /purchases/ ​​​​`

## Request

- Base URL: `https://gateway.pmnts-sandbox.io/v1.0`
- URL: `https://gateway.pmnts-sandbox.io/v1.0/purchases/ ​​​​`
- Auth: HTTP basic

## Headers

- `Content-Type` string

## Request body

- object
  - `amount` integer, required: A positive integer representing how much to charge, in the smallest currency unit (eg., 100 to charge $1.00, or 100 to Charge ¥100, a zero decimal currency)
  - `reference` string, required: Reference of the transaction
  - `customer_ip` string, required: RFC791-compliant IP address
  - `currency` string, required: Three letter [ISO currency code](https://pmnts.readme.io/v1.0/docs/iso-currency-codes-1), in UPPERCASE
  - `card_holder` string, required: Name of the card holder
  - `cvv` string: CVV card number. (3/4 characters)
  - `test` boolean: Indicates if this is a test transaction
  - `wallet` object: Wallet credentials. Described below
    - `type` string, required: Name of the wallet ('ApplePay', 'GooglePay')
    - `encPaymentData` string: required for type: VISA
    - `encKey` string: required for type: VISA
    - `callid` string: required for type: VISA
    - `token` string: required for type: APPLE, GOOGLE
    - `user_id` string: required for type: MASTERPASSEXPRESS
    - `origin_url` string: required for type: MASTERPASSEXPRESS
    - `card_id` string: required for type: MASTERPASSEXPRESS
    - `address_id` string: required for type: MASTERPASSEXPRESS
    - `checkout_resource_url` string: required for type: MASTERPASS
    - `oauth_token` string: required for type: MASTERPASS
    - `oauth_verifier` string: required for type: MASTERPASS
    - `checkout_id` string: required for type: ZIP_MONEY
    - `account_id` string: required for type: ZIP_MONEY
  - `metadata` object
  - `addendum_data` string

## Response `200`

200

- object
  - `successful` boolean
  - `response` object
    - `authorization` string
    - `id` string
    - `card_number` string
    - `card_holder` string
    - `card_expiry` string
    - `card_token` string
    - `card_type` string
    - `card_category` string
    - `card_subcategory` string
    - `amount` integer
    - `decimal_amount` integer
    - `successful` boolean
    - `message` string
    - `reference` string
    - `currency` string
    - `transaction_id` string
    - `settlement_date` string
    - `transaction_date` string
    - `response_code` string
    - `captured` boolean
    - `captured_amount` integer
    - `rrn` string
    - `cvv_match` string
    - `metadata` object
    - `addendum_data` object
  - `errors` unknown[]
    - unknown
  - `test` boolean

## Changes

- **2026-11-03** `a62ddbae3800`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fatzebra/apis/gateway/changes/purchases/%20​​​​/post.md)

---

[API](https://skmtc.dev/fatzebra/apis/gateway.md) - [All operations](https://skmtc.dev/fatzebra/apis/gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fatzebra/apis/gateway/revisions/a62ddbae3800?raw)