Request in-person card payment method

Request the in-person card payment method so your merchants can accept card payments with their terminal app.

Prerequisites

• A merchant profile with the status Enabled. If you don't have one yet, request a merchant profile first.
• A project access token or a user access token with Can manage members rights.

Request the payment method

Call the requestMerchantPaymentMethods mutation.

mutation RequestInPersonCardMethod {
  requestMerchantPaymentMethods(
    input: {
      merchantProfileId: "$YOUR_MERCHANT_PROFILE_ID"
      inPersonCard: {
        activate: true
      }
    }
  ) {
    ... on RequestMerchantPaymentMethodsSuccessPayload {
      merchantProfile {
        merchantPaymentMethods {
          ... on InPersonCardMerchantPaymentMethod {
            id
            methodId
            statusInfo {
              status
            }
            updatedAt
            version
          }
        }
      }
    }
    ... on ForbiddenRejection {
      __typename
      message
    }
    ... on MerchantProfileNotReadyRejection {
      __typename
      message
    }
  }
}

Payment method review

The payment method is created with the status PendingReview and version number 1.

Swan reviews all new merchant payment methods. We may contact you for more information before accepting or rejecting it.

After the review, the status updates to either Enabled or Rejected.

Status	Explanation
PendingReview	Payment method submitted and waiting for Swan's review.
WaitingForInformation	Swan needs more information. Refer to provide missing information to learn what to submit.
Enabled	Payment method approved. The merchant can accept in-person card payments.
Suspended	Swan suspended the payment method due to detected risk.
Disabled	Payment method deactivated.
Rejected	Payment method rejected. The decision is final. The merchant must submit a new request.

tip

Subscribe to merchant webhooks to monitor changes in payment method status. Review the full list of merchant webhooks or subscribe to them from your Dashboard > Developers > Webhooks.