Skip to main content

Documentation

Update Customer

Change one or more fields in a customer profile.

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

Note

For information on the customer in an account funding transaction (AFT), see Creating an AFT Payment.

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

    • addresses

    • Array of 'address' objects associated with this customer. For details of the 'address' object, see Create Address.

    • birth_country

    • Country where the customer was born. Two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see List Countries. English characters only. Relevant to an account funding transaction (AFT).

      Note

      Sandbox only.

    • business_vat_id

    • The tax ID number of the customer.

    • coupon

    • The ID of a coupon that is assigned to this customer.

    • date_of_birth

    • Date of birth of the customer. Format: DD/MM/YYYY

      Required for an account funding transaction (AFT).

      Note

      Sandbox only.

    • 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. Recommended for an account funding transaction (AFT).

    • 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.

      • name

      • The name of the individual customer or the business name.

      • nationality

      • The citizenship of the customer. Two-letter ISO 3166-1 ALPHA-2 code for the country. To determine the code for a country, see List Countries. English characters only. Relevant to an account funding transaction (AFT).

        Note

        Sandbox only.

      • occupation

      • Occupation of the customer. Maximum: 35 characters. Relevant to an account funding transaction (AFT).

        Note

        Sandbox only.

      • phone_number

      • Customer's primary phone number in E.164 format.

    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",
              "occupation": "",
              "birth_country": "",
              "date_of_birth": "",
              "nationality": ""
          }
      }
    • 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": "",
              "occupation": "",
              "birth_country": "",
              "date_of_birth": "",
              "nationality": ""
          }
      }