Update Customer

Change one or more fields in a customer profile.

To clear a field, set it to an empty string.

This method triggers the Customer Created Webhook. This webhook contains the same information as the response.

Parameters

Request Path Parameters

- customer
  ID of the customer profile. String starting with cus_.

Request Header Parameters

Request Body Parameters

- addresses
- Array of 'address' objects associated with this customer. For details of the 'address' object, see Create Address.
  canton
  Name of the canton administrative subdivision, as used in banking.
  city
  City portion of the address. Required for issuance of a card to the wallet contact.
  country
  The two-letter ISO 3166-1 ALPHA-2 code for the country.
  district
  Name of the district administrative subdivision, as used in banking.
  line_1
  Line 1 of the address, such as a building number and street name.
  line_2
  Line 2 of the address, such as a suite or apartment number, or the name of a named building.
  line_3
  Line 3 of the address.
  metadata
  A JSON object defined by the client. See Metadata.
  name
  The name of a contact person or an "in care of" person at this address. For a personal wallet contact type, alphabetic characters and spaces.
  phone_number
  Phone number associated with this specific address in E.164 format. Must be unique.
  state
  State or province portion of the address.
  zip
  Postal code portion of the address.
- business_vat_id
- The tax ID number of the customer.
- coupon
- The ID of a coupon that is assigned to this customer.
- default_payment_method
- The payment method that is used when the transaction does not specify a payment method. String starting with card_ or other_.
- description
- A text description of the customer.
- email
- Customer's email address.
- ewallet
- ID of the wallet that is linked to the customer. String starting with ewallet_.
- invoice_prefix
- A custom string that is prefixed to all invoices for this customer.
- metadata
- A JSON object defined by the client. See Metadata.
- name
- The name of the individual customer or the business name.
- phone_number
- Customer's primary phone number in E.164 format.

Response Parameters

- addresses
- Describes the addresses associated with this customer. For details of the fields in the 'address' object, see Create Address.
- business_vat_id
- The tax ID number of the customer. Relevant when the customer is a business.
- category
- Category of payment method. One of the following:
  bank_redirect
  bank_transfer
  card
  card_to_card
  cash
  ewallet
  rapyd_ewallet
- coupon
- The ID of a discount coupon that is assigned to this customer. The coupon must use the same currency as the customer's default payment method.
- created_at
- Time of creation of this customer, in Unix time.
- customer
- ID of the customer profile, a string starting with cus_.
- default_payment_method
- The payment method that is used when the payment object or subscription does not specify a payment method. The value must also appear in the payment_methods list. The payment method is referenced by its name field.
- delinquent
- Indicates whether there is currently a failure of an automatic payment that is part of a subscription, or an invoice that was not paid when due.
- description
- A text description of the customer.
- discount
- Contains information about the coupon that applies to the customer.
  To add a discount to a customer, see Update Customer.
- email
- Customer's email address. Maximum 512 characters.
- ewallet
- ID of the wallet that is linked to the customer. String starting with ewallet_.
  Each wallet can be associated with only one customer.
- fields
- Contains the fields that are for the specific payment method.
  To determine what fields are required for the payment method, see Get Payment Method Required Fields.
- id
- ID of the customer profile. String starting with cus_.
- invoice_prefix
- A custom string that is prefixed to all invoices for this customer.
- metadata
- A JSON object defined by the client. See Metadata.
- name
- The name of the customer.
- next_action
- Indicates the next action for completing the payment. One of the following values:
  3d_verification - The next action is 3DS authentication. Relevant only to card payments.
  pending_capture - The next action is pending the capture of the amount. Relevant only to card payments when the amount is not zero.
  pending_confirmation - The next action is pending the confirmation for the payment. Relevant to all payment methods excluding card payment.
  not_applicable - The payment has completed or the next action is not relevant.
- payment_methods
- An object containing the following fields:
  data
  A list of up to three payment methods.
  acs_check
  Results of the Access Control Server (ACS) check. Possible values:
  pass
  fail
  unavailable
  unchecked
  Relevant to cards.
  address
  Address of the customer.
  canton
  Name of the canton administrative subdivision, as used in banking.
  city
  City portion of the address.
  country
  The two-letter ISO 3166-1 ALPHA-2 code for the country.
  created_at
  Time of creation of the object, in Unix time.
  district
  Name of the district administrative subdivision, as used in banking.
  id
  ID of the address object.
  line_1
  Line 1 of the address, such as a building number and street name.
  line_2
  Line 2 of the address, such as a suite or apartment number, or the name of a named building.
  line_3
  Line 3 of the address.
  metadata
  A JSON object defined by the client. See Metadata.
  name
  The name of a contact person or an "in care of" person at this address. For a personal wallet contact, alphabetic characters and spaces.
  phone_number
  Phone number associated with this specific address in E.164 format. Must be unique.
  state
  State or province portion of the address.
  zip
  Postal code portion of the address.
  bin_details
  Bank identification details. Includes the following fields:
  bin_number
  BIN number of the bank.
  brand
  The brand of the card. For example, Visa.
  country
  Country of the bank that issued the card.
  type
  The type of the card:
  credit
  debit
  prepaid
  category
  Category of payment method. One of the following:
  bank_redirect
  bank_transfer
  card
  card_to_card
  cash
  ewallet
  rapyd_ewallet
  cvv_check
  Verification of the card’s CVV. Valid values:
  pass
  fail
  unavailable
  unchecked
  fingerprint_token
  Hash of the card number, expiration date and CVV.
  Relevant to cards.
  id
  ID of the Payment Method object. String starting with card_ or other_.
  image
  A URL to the image of the icon for the type of payment method.
  last4
  Last 4 digits of the card.
  Relevant to card payment methods.
  metadata
  A JSON object defined by the client. See Metadata.
  name
  Full name of the customer.
  next_action
  Indicates the next action for completing the payment. One of the following values:
  3d_verification - The next action is 3DS authentication. Relevant only to card payments.
  pending_capture - The next action is pending the capture of the amount. Relevant only to card payments when the amount is not zero.
  pending_confirmation - The next action is pending the confirmation for the payment. Relevant to all payment methods excluding card payment.
  not_applicable - The payment has completed or the next action is not relevant.
  supporting_documentation
  Reserved.
  type
  Name of the payment method type. For example, us_mastercard_card.
  To get a list of payment methods for a country, use List Payment Methods by Country.
  webhook_url
  Reserved.
  has_more
  Indicates whether there are more than three payment methods for this customer.
  total_count
  Total number of payment methods for this customer.
  url
  URL for requesting all of the payment methods for this customer.
- phone_number
- Customer's primary phone number in E.164 format. The merchant is responsible for verifying that the number is correct.
- subscriptions
- Describes the subscriptions associated with this customer. Array of objects. For details of the fields in the 'subscriptions' object, see Create Subscription.

Code Samples

.NET

using System;
using System.Text.Json;

namespace RapydApiRequestSample
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                string customerId = "cus_d3ed65d5091a8398cc3651bcedec1201";

                var requestObj = new
                {
                    default_payment_method = "card_0ef22c3b9fa5991a4da957d3dcee2e7b"
                };

                string request = JsonSerializer.Serialize(requestObj);

                string result = RapydApiRequestSample.Utilities.MakeRequest("POST", $"/v1/customers/{customerId}", request);

                Console.WriteLine(result);
            }
            catch (Exception e)
            {
                Console.WriteLine("Error completing request: " + e.Message);
            }
        }
    }
}

JavaScript

const makeRequest = require('<path-to-your-utility-file>/utilities').makeRequest;

async function main() {
  try {
    const body = {
      default_payment_method: 'card_0ef22c3b9fa5991a4da957d3dcee2e7b'
    };
    const result = await makeRequest(
      'POST',
      '/v1/customers/cus_d3ed65d5091a8398cc3651bcedec1201',
      body
    );

    console.log(result);
  } catch (error) {
    console.error('Error completing request', error);
  }
}

PHP

<?php
$path = $_SERVER['DOCUMENT_ROOT'];
$path .= "/<path-to-your-utility-file>/utilities.php";
include($path);

$body = [
    "default_payment_method"=> "card_0ef22c3b9fa5991a4da957d3dcee2e7b"
];

try {
    $object = make_request('post', "/v1/customers/cus_d3ed65d5091a8398cc3651bcedec1201", $body);
    var_dump($object);
} catch (Exception $e) {
    echo "Error: $e";
}
?>

Python

from pprint import pprint

from utilities import make_request

customer_data = {
    "default_payment_method": "card_0ef22c3b9fa5991a4da957d3dcee2e7b",
}
result = make_request(method='post', path='/v1/customers/cus_d3ed65d5091a8398cc3651bcedec1201', body=customer_data)
pprint(result)

/v1/customers/:customer

Add Default Payment Method

curl -X post
https://sandboxapi.rapyd.net/v1/customers/cus_d3ed65d5091a8398cc3651bcedec1201
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "default_payment_method": "card_0ef22c3b9fa5991a4da957d3dcee2e7b"
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "86591aab-d648-4dd2-8e38-8b06c0b6f8c3"
    },
    "data": {
        "id": "cus_d3ed65d5091a8398cc3651bcedec1201",
        "delinquent": false,
        "discount": null,
        "name": "John Doe",
        "default_payment_method": "card_0ef22c3b9fa5991a4da957d3dcee2e7b",
        "description": "",
        "email": "johndoe1@rapyd.net",
        "phone_number": "+14155559983",
        "invoice_prefix": "JD-",
        "addresses": [],
        "payment_methods": {
            "data": [
                {
                    "id": "card_0ef22c3b9fa5991a4da957d3dcee2e7b",
                    "type": "us_visa_card",
                    "category": "card",
                    "metadata": {},
                    "image": "https://iconslib.rapyd.net/checkout/us_visa_card.png",
                    "webhook_url": "",
                    "supporting_documentation": "",
                    "next_action": "3d_verification",
                    "name": "John Doe",
                    "last4": "1111",
                    "acs_check": "unchecked",
                    "cvv_check": "unchecked",
                    "bin_details": {
                        "type": null,
                        "brand": null,
                        "country": null,
                        "bin_number": "411111"
                    },
                    "expiration_year": "25",
                    "expiration_month": "12",
                    "fingerprint_token": "ocfp_e599f990674473ce6283b245e9ad2467"
                },
                {
                    "id": "other_bc428c38988a5d5aa5a09b79f32b2b15",
                    "type": "us_ach_bank",
                    "category": "bank_transfer",
                    "metadata": {
                        "merchant_defined": true
                    },
                    "image": "https://iconslib.rapyd.net/checkout/us_ach_bank.png",
                    "webhook_url": "",
                    "supporting_documentation": "",
                    "next_action": "not_applicable",
                    "last_name": "Doe",
                    "first_name": "John",
                    "company_name": "Acme",
                    "account_number": "retetert-345345345345-ertretretert-34534534t",
                    "routing_number": "2345345345345345",
                    "payment_purpose": "goods",
                    "proof_of_authorization": false
                }
            ],
            "has_more": false,
            "total_count": 2,
            "url": "/v1/customers/cus_d3ed65d5091a8398cc3651bcedec1201/payment_methods"
        },
        "subscriptions": null,
        "created_at": 1634217004,
        "metadata": {
            "merchant_defined": true
        },
        "business_vat_id": "123456789",
        "ewallet": "ewallet_0430df85c650a9a0a87f677d281b3f59"
    }
}

Add Discount

curl -X post
https://sandboxapi.rapyd.net/v1/customers/cus_c62e8561f1f9217676819dce60accc08
-H 'access_key: your-access-key-here'
-H 'Content-Type: application/json'
-H 'idempotency: your-idempotency-parameter-here'
-H 'salt: your-random-string-here'
-H 'signature: your-calculated-signature-here'
-H 'timestamp: your-unix-timestamp-here'
-d '{
    "coupon": "coupon_4ab30530e8a7352ffe715deecfab57b9"
}
'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "776819ef-0fb4-4e83-aa08-e159569c050b"
    },
    "data": {
        "id": "cus_c62e8561f1f9217676819dce60accc08",
        "delinquent": false,
        "discount": {
            "id": "dis_d41d8cd98f00b204e9800998ecf8427e",
            "coupon": {
                "id": "coupon_4ab30530e8a7352ffe715deecfab57b9",
                "amount_off": 2,
                "created": 1646825743,
                "currency": "USD",
                "duration": "forever",
                "duration_in_months": 0,
                "max_redemptions": 1,
                "metadata": {
                    "merchant_defined": true
                },
                "percent_off": 0,
                "redeem_by": 0,
                "times_redeemed": 0,
                "discount_valid_until": 0,
                "discount_validity_in_months": 0,
                "discount_duration_in_uses": 0,
                "description": "",
                "valid": true
            },
            "end": -1,
            "start": 1646834885,
            "subscription": "",
            "number_of_uses": 0,
            "valid": true
        },
        "name": "John Doe",
        "default_payment_method": "",
        "description": "",
        "email": "john_doe@rapyd.net",
        "phone_number": "",
        "invoice_prefix": "",
        "addresses": [],
        "payment_methods": {
            "data": [
                {
                    "id": "other_83f8ce8cd8cfb19bb61758b224c55cfe",
                    "type": "us_psc_cash",
                    "category": "cash",
                    "metadata": {},
                    "image": "https://iconslib.rapyd.net/checkout/us_psc_cash.png",
                    "webhook_url": "",
                    "supporting_documentation": "",
                    "next_action": "not_applicable"
                }
            ],
            "has_more": false,
            "total_count": 1,
            "url": "/v1/customers/cus_c62e8561f1f9217676819dce60accc08/payment_methods"
        },
        "subscriptions": null,
        "created_at": 1616316203,
        "metadata": {},
        "business_vat_id": "",
        "ewallet": ""
    }
}

In this section:

Documentation