Developer Portal

eWallet

Securely capture payment information in your mobile app or online interface with our mobile hosted payment page available via SDK.


Enable your customers to provide you with payment card information through your online interface or mobile app. Heartland Hosted Payment Page service securely captures and stores customer payment information. A token is provided for your system to save and use whenever a customer payment is processed, eliminating the need for your system to record sensitive credit card number information.

Prepare to Charge a Credit Card

For the below sections, the code samples will reference the following objects:

Prepare to charge a credit card

using GlobalPayments.Api.Entities;
using GlobalPayments.Api.PaymentMethods;

var card = new CreditCardData {
    Token = "single- or multi-use token"
};

var address new Address {
    PostalCode = "12345"
};
<?php
use GlobalPayments\Api\Entities\Address;
use GlobalPayments\Api\PaymentMethods\CreditCardData;

$card = new CreditCardData();
$card->token = "single- or multi-use token";

$address = new Address();
$address->postalCode = "12345";
import com.global.api.entities.Address;
import com.global.api.paymentMethods.CreditCardData;

CreditCardData card = new CreditCardData();
card.setToken("single- or multi-use token");

Address address = new Address();
address.setCode("12345");
# coming soon
from globalpayments.api.entities import Address
from globalpayments.api.payment_methods import CreditCardData

card = CreditCardData()
card.token = 'single- or multi-use token'

address = Address()
address.postal_code = '12345'
import { Address, CreditCardData } from "globalpayments-api";

const card = new CreditCardData();
card.token = "single- or multi-use token";

const address = new Address();
address.code = "12345";

Not using tokens?

Our SDKs support using tokens in place of card data, but using tokens is optional if you have other requirements. Review other options in the Credit Card section of our SDK documentation.

Using Multi-Use Tokens

Multi-Use Tokenization allows a secure and PCI friendly way to store credit card information within your system. A multi-use token can be generated as part of any of our initial gateway calls: charge, verify, or authorize.

Requesting a multi-use token

var response = card.Verify()
    .WithAddress(address)
    .WithRequestMultiUseToken(true)
    .Execute();
<?php
$response = $card->verify()
    ->withAddress($address)
    ->withRequestMultiUseToken(true)
    ->execute();
import com.global.api.entities.Transaction;

Transaction response = card.verify()
    .withAddress(address)
    .withRequestMultiUseToken(true)
    .execute();
# coming soon
response = card.verify() \
    .with_address(address) \
    .with_request_multi_use_token(True) \
    .execute()
const response = await card.verify()
  .withAddress(address)
  .withRequestMultiUseToken(true)
  .execute();

Charging a multi-use token

var response = card.Charge(10.00m)
    .WithCurrency("USD")
    .WithAddress(address)
    .Execute();
<?php
$response = $card->charge(10)
    ->withCurrency("USD")
    ->withAddress($address)
    ->execute();
import com.global.api.entities.Transaction;
import java.math.BigDecimal;

Transaction response = card.charge(new BigDecimal("10"))
    .withCurrency("USD")
    .withAddress(address)
    .execute();
# coming soon
repsonse = card.charge(10) \
    .with_currency('USD') \
    .with_address(address) \
    .execute()
const response = await card.charge(10)
  .withCurrency("USD")
  .withAddress(address)
  .execute();

Next Steps

Learn more about eWallet payments with: