Order cards

Overview

Customers can order a primary card and linked cards through the Cards APIs. Use the sections below to understand each flow, then implement the endpoints in the API reference for your program.

Order a primary card

This flow lets a customer order a primary card to access their Payoneer account funds. The primary card has its own card number, balance, limits, and expiration date. It can be used to make purchases or withdraw funds from the customer's Payoneer account.

Prior to calling the order primary card API, use the Get order primary card eligibility endpoint to check whether the account can order a primary card in a given currency. That call helps you review options for primary card type, card plans, shipping methods, and applicable terms and conditions before the first card order is placed.

Activate a card

After a primary card is ordered, it must be activated before it can be used. Call the Activate Card endpoint to move the primary card to an active state — you can confirm the current state first with Get Card Details.

Only the primary card needs to be activated. Linked cards are activated automatically when they are issued, so there is no separate activation step for them.

Order a linked card

This flow orders a linked card that is linked to the customer's existing primary card. The linked card shares most attributes with the primary card—including balance, limits, and expiration date—but has a different card number. Linked cards access funds in the same currency as the primary card.

Before a linked card can be created, all of the following must be true:

  • The customer has a Payoneer account.
  • The customer has a primary card in the desired currency.

Suggested flow:

  1. Get Card Details — See whether the primary card is active. If it is not, you may need to call Activate Card.
  2. Order linked card eligibility — Once the primary card is active, use this to learn which currencies you may order linked cards in and how many linked cards (if any) the customer can order.
  3. Order linked card — Request one or more virtual cards linked to the specified primary card, without exceeding the allowed total. Cards can be given nicknames; default nicknames may apply if you omit them.

Exact paths, request bodies, and response fields are in the API reference under your program's Cards operations.