关于通过PayPal Go API创建客户及卡片操作的技术咨询

Hey there! Let's tackle your PayPal Go API questions one by one— I’ve worked with this setup before, so here’s what I can share:

1. Creating a Customer & Binding a Vaulted Card #

Absolutely, this is totally feasible with the PayPal Go SDK (v2). It sounds like you might have missed the Customers module in the docs— it’s part of the core REST SDK. Here’s a step-by-step implementation:

First, create a customer record, then bind your existing vaulted card (using its payment token) to that customer:

package main

import (
	"context"
	"fmt"
	"github.com/paypal/paypal-rest-sdk-go/v2/paypal"
)

func createCustomerAndBindCard() error {
	// Initialize client with your sandbox/live credentials
	client, err := paypal.NewClient("YOUR_CLIENT_ID", "YOUR_SECRET", paypal.SandboxMode)
	if err != nil {
		return fmt.Errorf("failed to init client: %w", err)
	}

	// Step 1: Create a customer profile
	customerReq := &paypal.CustomerRequest{
		Email:  "customer@example.com",
		Name:   &paypal.Name{GivenName: "Jane", Surname: "Smith"},
		Phone:  &paypal.Phone{PhoneNumber: &paypal.PhoneNumber{NationalNumber: "5551234567"}},
		Address: &paypal.AddressPortable{
			AddressLine1: "456 Oak Ave",
			AdminArea2:   "Austin",
			AdminArea1:   "TX",
			PostalCode:   "78701",
			CountryCode:  "US",
		},
	}

	customer, err := client.Customers.Create(context.Background(), customerReq)
	if err != nil {
		return fmt.Errorf("failed to create customer: %w", err)
	}
	fmt.Printf("Created Customer ID: %s\n", customer.ID)

	// Step 2: Bind your vaulted card (use the payment token from your existing vault setup)
	vaultedCardToken := "YOUR_VAULTED_PAYMENT_TOKEN_ID"
	addPaymentMethodReq := &paypal.CustomerPaymentMethodRequest{
		PaymentToken: &paypal.PaymentToken{ID: vaultedCardToken},
	}

	_, err = client.Customers.AddPaymentMethod(context.Background(), customer.ID, addPaymentMethodReq)
	if err != nil {
		return fmt.Errorf("failed to bind card to customer: %w", err)
	}
	fmt.Println("Card successfully linked to customer")

	return nil
}

2. Getting a Card Token/Nonce After Submitting Card Details #

Yes! When you vault a card via the Go SDK, the response returns a unique payment_token (the ID field in the VaultCreateCardResponse object). This token acts exactly like a card nonce— it’s a secure reference to the stored card, and you can use it to initiate transactions without handling raw card data.

Here’s how you grab it:

// After submitting card details to the vault
cardReq := &paypal.VaultCardRequest{
	Card: &paypal.Card{
		Number:      "4111111111111111",
		ExpireMonth: "12",
		ExpireYear:  "2028",
		Cvv:         "123",
	},
}

cardResp, err := client.Vault.CreateCard(context.Background(), cardReq)
if err != nil {
	return fmt.Errorf("failed to vault card: %w", err)
}
// This is your secure card token/nonce
cardToken := cardResp.ID

3. Setting a Customer’s Default Card #

You can absolutely set a default card for a customer using a PATCH request to the Customers API. This lets you specify which linked payment token should be used as the default for future transactions.

Here’s the code to do it:

func setDefaultCustomerCard(customerID, targetPaymentToken string) error {
	client, err := paypal.NewClient("YOUR_CLIENT_ID", "YOUR_SECRET", paypal.SandboxMode)
	if err != nil {
		return fmt.Errorf("failed to init client: %w", err)
	}

	// Define the patch operation to update the default payment method
	patchOps := []paypal.Patch{
		{
			Op:    "replace",
			Path:  "/default_payment_method",
			Value: targetPaymentToken,
		},
	}

	_, err = client.Customers.Update(context.Background(), customerID, patchOps)
	if err != nil {
		return fmt.Errorf("failed to set default card: %w", err)
	}
	fmt.Println("Default card updated successfully")

	return nil
}

Quick Notes #

• Make sure you’re using the latest version of the PayPal Go SDK (github.com/paypal/paypal-rest-sdk-go/v2)— older versions might not have full Customers API support.
• Double-check your API credentials have the necessary permissions (e.g., vault:tokens:read/write and customers:read/write).

内容的提问来源于stack exchange，提问作者Puneet