---
title: "apple-pay/charge"
method: POST
path: "/apple-pay/charge"
tags: ["Digital Wallet Endpoints"]
---

# apple-pay/charge

`POST /apple-pay/charge`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/apple-pay/charge`
- Auth: none declared

This endpoint is to create a Apple Pay transaction to fund your VoPay account, charging the amount specified to the card linked to the provided Apple Pay Token.

 If a ClientAccountID is provided, the client account's default Apple Pay wallet will be used for the transaction.

Note: You must first generate a ApplePayToken using the /apple-pay/generate-embed-url endpoint.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `ClientAccountID` string: Client Account ID
  - `ContactID` string: The ID of the contact to use for this transaction. The contacts payment method associated with this transaction type will be used.
  - `ApplePayToken` string, required: The token identifying the Apple Pay wallet to charge (returned from /apple-pay/generate-embed-url).
  - `Amount` number, required: The amount to charge from the customer's Apple Pay wallet.
  - `Currency` string: 3 character currency code for the currency to be charged to the customer's Apple Pay wallet. If this is not specified the transaction will use the account's local currency.
  - `Country` string: Customer's country specified using full country name or ISO 3166-1 alpha-2 code. If this is not specified the transaction will use the local country.
  - `IdempotencyKey` string: A unique key which the server can use to recognize and reject subsequent retries of the same request.
  - `GLCode` string: An optional unique identification general ledger code.
  - `TransactionTypeCode` string: CPA transaction code. Use the /api/v2/account/transactions/codes endpoint to retrieve a list of valid transaction codes. If not specified, the transaction will be created using code 450 (miscellaneous).

## Response `200`

- object
  - `Success` boolean, required: true if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `TransactionID` integer, required: The unique ID of the transaction that was just submitted.
  - `Flagged` string: Details on why the transaction was flagged, if applicable. Flagged transactions will need to be confirmed by using the /account/transaction/confirm endpoint.

---

[API](https://skmtc.dev/vopay/apis/payment-rails.md) - [All operations](https://skmtc.dev/vopay/apis/payment-rails/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/payment-rails/revisions/d6fe8969ddcf?raw)