Skip to main content

Documentation

Release Funds from Escrow

Release funds from escrow to the designated Rapyd wallet.

The status of the escrow must be on_hold or released. When the funds are transferred into escrow via partial payments, this method releases funds currently in the escrow. This method transfers funds from received balance to available balance.

    • payment

    • ID of the payment. String starting with payment_.

    • escrow

    • ID of the escrow. String starting with escrow_.

    • ewallets

    • Describes the wallets and the releases from escrow.

Code Samples
    • .NET

      • using System;
        
        namespace RapydApiRequestSample
        {
            class Program
            {
                static void Main(string[] args)
                {
                    try
                    {
                        string payment = "payment_414360121003a3c3bdaf4f3cb1d9a1f8";
                        string escrow = "escrow_006fa9200fd7436a74b75fac963fadcf";
        
                        string result = RapydApiRequestSample.Utilities.MakeRequest("POST", $"/v1/payments/{payment}/escrows/{escrow}/escrow_releases");
        
                        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 result = await makeRequest(
              'POST',
              '/v1/payments/payment_b8f1f3c75eb74fc318daa89418f6c8e9/escrows/escrow_8484400128afa6aa8b31297088e81f45/escrow_releases'
            );
        
            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);
        
        try {
            $object = make_request('post', "/v1/payments/payment_a813e2bac82bad744b98defa727f7e3c/escrows/escrow_f3c4db8e23bde2973704a7f9f32baabb/escrow_releases");
            var_dump($object);
        } catch(Exception $e) {
            echo "Error: $e";
        }
        ?>
    • Python

      • from pprint import pprint
        
        from utilities import make_request
        
        payment = "payment_35544ff0d05c578c87ad171f2dd2ba6e"
        escrow = "escrow_71193eec47ff06ce000e0c4423cbb68d"
        
        response = make_request(method='post',
                                path=f'/v1/payments/{payment}/escrows/{escrow}/escrow_releases')
        pprint(response)
        
  • /v1/payments/:payment/escrows/:escrow/escrow_releases

  • Release Funds from Escrow

  • curl -X post
    https://sandboxapi.rapyd.net/v1/payments/payment_7150ae9ae089c7f70d87291afc0fe92f/escrows/escrow_e4a2437fd8e5cf467028c2762e46ac8d/escrow_releases
    -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 '{
        "ewallets": [
            {
                "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861",
                "amount": 1
            }
        ]
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "1c814530-18f1-4d81-9177-f4e26e18097d"
        },
        "data": {
            "id": "escrow_e4a2437fd8e5cf467028c2762e46ac8d",
            "payment": "payment_7150ae9ae089c7f70d87291afc0fe92f",
            "currency": "EUR",
            "amount_on_hold": 9,
            "total_amount_released": 1,
            "status": "released",
            "escrow_release_days": 5,
            "escrow_releases": {
                "data": [
                    {
                        "id": "er_acd170e0ef62743157e7156f0272b5e9",
                        "amount": 1,
                        "trigger": "event",
                        "proportional_release": false,
                        "ewallets": [
                            {
                                "ewallet": "ewallet_c1943cfeda5f98247ab117e5d2648861",
                                "amount": 1
                            }
                        ],
                        "created_at": 1698303566,
                        "currency": "EUR"
                    }
                ],
                "has_more": false,
                "total_count": 1,
                "url": "/v1/payments/payment_7150ae9ae089c7f70d87291afc0fe92f/escrows/escrow_e4a2437fd8e5cf467028c2762e46ac8d/escrow_releases"
            },
            "created_at": 1698303122,
            "updated_at": 1698303566,
            "last_payment_completion": 1698303122
        }
    }
  • Release Funds from Escrow - Multiple Wallets

  • curl -X post
    https://sandboxapi.rapyd.net/v1/payments/payment_eb7a6284d94590b37f9e7ab889120e96/escrows/escrow_532681d237b58b1a2ebde91450f35e26/escrow_releases
    -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 '{
        "ewallets": [
            {
                "ewallet": "ewallet_82dd0417a86aebb564da2f96936ce2d2",
                "amount": 10
            },
            {
                "ewallet": "ewallet_a866886dc65d835ef42fe1314509b8ec",
                "amount": 50
            }
        ]
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "acfebfb0-8bfe-41f3-a267-504263f1ea32"
        },
        "data": {
            "id": "escrow_532681d237b58b1a2ebde91450f35e26",
            "payment": "payment_eb7a6284d94590b37f9e7ab889120e96",
            "amount_on_hold": 0,
            "total_amount_released": 135,
            "status": "released",
            "escrow_release_days": 9,
            "escrow_releases": {
                "data": [{
                        "id": "er_9c10c6449aa1a048f3a6db93a1aacb5b",
                        "amount": 135,
                        "trigger": "event",
                        "proportional_release": false,
                        "ewallets": [{
                                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                                "amount": 87.75
                            }, {
                                "ewallet": "ewallet_a4c07a32d2f0883a6093f9dc08800f5f",
                                "amount": 47.25
                            }
                        ],
                        "created_at": 1567353002
                    }
                ],
                "has_more": false,
                "total_count": 1,
                "url": "/v1/payments/payment_eb7a6284d94590b37f9e7ab889120e96/escrows/escrow_532681d237b58b1a2ebde91450f35e26/escrow-releases"
            },
            "created_at": 1567352916,
            "updated_at": 1567353002,
            "last_payment_completion": 1567352916
        }
    }
    
  • Release Funds from Escrow - Multiple Wallets by Percentage

  • curl -X post
    https://sandboxapi.rapyd.net/v1/payments/payment_3500a4e23ef78b6fd97a02ca165d7056/escrows/escrow_82c56bdc561442c75c7b06a2490eadfc/escrow_releases
    -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 '{
        "ewallets": [
            {
                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                "percentage": 10
            },
            {
                "ewallet": "ewallet_a4c07a32d2f0883a6093f9dc08800f5f",
                "percentage": 15
            }
        ]
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "ffab6271-bea3-4fca-9c7f-58f96abb50c1"
        },
        "data": {
            "id": "escrow_82c56bdc561442c75c7b06a2490eadfc",
            "payment": "payment_3500a4e23ef78b6fd97a02ca165d7056",
            "amount_on_hold": 99,
            "total_amount_released": 33,
            "status": "released",
            "escrow_release_days": 9,
            "escrow_releases": {
                "data": [
                    {
                        "id": "er_a1e1d0410431beb590dcdc98fbd9a45a",
                        "amount": 33,
                        "trigger": "event",
                        "proportional_release": false,
                        "ewallets": [
                            {
                                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                                "amount": 13.2
                            },
                            {
                                "ewallet": "ewallet_a4c07a32d2f0883a6093f9dc08800f5f",
                                "amount": 19.8
                            }
                        ],
                        "created_at": 1567352773
                    }
                ],
                "has_more": false,
                "total_count": 1,
                "url": "/v1/payments/payment_3500a4e23ef78b6fd97a02ca165d7056/escrows/escrow_82c56bdc561442c75c7b06a2490eadfc/escrow_releases"
            },
            "created_at": 1567352677,
            "updated_at": 1567352773,
            "last_payment_completion": 1567352677
        }
    }
  • Release Funds from Escrow - Multiple Wallets by Amount

  • curl -X post
    https://sandboxapi.rapyd.net/v1/payments/payment_4feb51668ab87dfb7ebf2e3a924e5b0b/escrows/escrow_3b1980f02d228dfb00bb3863428e1098/escrow_releases
    -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 '{
        "ewallets": [
            {
                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                "amount": 5
            },
            {
                "ewallet": "ewallet_a4c07a32d2f0883a6093f9dc08800f5f",
                "amount": 5
            }
        ]
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "2e21886e-be7e-4f16-91b2-e3247cc69a01"
        },
        "data": {
            "id": "escrow_3b1980f02d228dfb00bb3863428e1098",
            "payment": "payment_4feb51668ab87dfb7ebf2e3a924e5b0b",
            "amount_on_hold": 90,
            "total_amount_released": 10,
            "status": "released",
            "escrow_release_days": 9,
            "escrow_releases": {
                "data": [
                    {
                        "id": "er_ac26f6073590d2508d9a90abc4e4c793",
                        "amount": 10,
                        "trigger": "event",
                        "proportional_release": false,
                        "ewallets": [
                            {
                                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                                "amount": 5
                           },
                            {
                                "ewallet": "ewallet_a4c07a32d2f0883a6093f9dc08800f5f",
                                "amount": 5
                            }
                        ],
                        "created_at": 1567351469
                    }
                ],
                "has_more": false,
                "total_count": 1,
                "url": "/v1/payments/payment_4feb51668ab87dfb7ebf2e3a924e5b0b/escrows/escrow_3b1980f02d228dfb00bb3863428e1098/escrow_releases"
            },
            "created_at": 1567350869,
            "updated_at": 1567351469,
            "last_payment_completion": 1567350869
        }
    }
  • Release Funds from Escrow - One Wallet of Multiple Wallets

  • curl -X post
    https://sandboxapi.rapyd.net/v1/payments/payment_46e773b1ee0f728b4834c56d229b1cb6/escrows/escrow_d6b99ddac42ce50cd0265b17c7845f0d/escrow_releases
    -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 '{
        "ewallets": [
            {
                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                "amount": 5
            }
        ]
    }
    '
    
  • {
        "status": {
            "error_code": "",
            "status": "SUCCESS",
            "message": "",
            "response_code": "",
            "operation_id": "61f8f4dc-9ff0-4583-91ec-be479a6bc907"
        },
        "data": {
            "id": "escrow_d6b99ddac42ce50cd0265b17c7845f0d",
            "payment": "payment_46e773b1ee0f728b4834c56d229b1cb6",
            "amount_on_hold": 20,
            "total_amount_released": 5,
            "status": "released",
            "escrow_release_days": 5,
            "escrow_releases": {
                "data": [
                    {
                        "id": "er_38579274f4aadb9304158197ffac7678",
                        "amount": 5,
                        "trigger": "event",
                        "proportional_release": false,
                        "ewallets": [
                            {
                                "ewallet": "ewallet_7d93833c8d7e422446de43e41e116af9",
                                "amount": 5
                            }
                        ],
                        "created_at": 1567347835
                    }
                ],
                "has_more": false,
                "total_count": 1,
                "url": "/v1/payments/payment_46e773b1ee0f728b4834c56d229b1cb6/escrows/escrow_d6b99ddac42ce50cd0265b17c7845f0d/escrow_releases"
            },
            "created_at": 1567347485,
            "updated_at": 1567347835,
            "last_payment_completion": 1567347486
        }
    }